@algolia/wizard 0.34.0-rc.125.245 → 0.35.0-rc.125.251

package/dist/main.js

@@ -253,6 +253,7 @@ var useWizard = create((set, get) => ({
   cliOutput: [],
   targetIndex: null,
   writtenFiles: [],
+  approvedCommands: /* @__PURE__ */ new Set(),
   logs: [],
   error: null,
   inputReq: null,
@@ -348,6 +349,10 @@ var useWizard = create((set, get) => ({
   setTargetIndex: (index) => set({ targetIndex: index }),
   recordWrittenFile: (path) => set((s) => ({ writtenFiles: [...s.writtenFiles, path] })),
   clearWrittenFiles: () => set({ writtenFiles: [] }),
+  isCommandApproved: (command, cwd) => get().approvedCommands.has(`${cwd}\0${command}`),
+  approveCommand: (command, cwd) => set((s) => ({
+    approvedCommands: new Set(s.approvedCommands).add(`${cwd}\0${command}`)
+  })),
   logStart: (kind, name, input) => {
     const id = nanoid();
     set((s) => ({
@@ -396,6 +401,7 @@ var useWizard = create((set, get) => ({
       cliOutput: [],
       targetIndex: null,
       writtenFiles: [],
+      approvedCommands: /* @__PURE__ */ new Set(),
       logs: [],
       error: null,
       inputReq: null,
@@ -1121,576 +1127,138 @@ function PromptInput() {
   ] });
 }
 
-// src/ui/Welcome.tsx
-import { dirname as dirname2, join as join3 } from "node:path";
-import { fileURLToPath } from "node:url";
-import { useState as useState7 } from "react";
-import { Box as Box10, Spacer, Text as Text10, useInput as useInput3, useWindowSize as useWindowSize5 } from "ink";
+// src/workflows/default.ts
+import { z as z29 } from "zod";
 
-// src/ui/copy/welcome.ts
-var sidebarItems = [
-  {
-    title: "scan your project",
-    description: "detect models, schemas, and data worth indexing"
-  },
-  {
-    title: "select and index",
-    description: "push 100 records to Algolia in seconds"
-  },
-  {
-    title: "detect your stack",
-    description: "whatever language and framework you already use"
-  },
-  {
-    title: "scaffold a search UI",
-    description: "a search box and results, wired into your app"
-  },
-  {
-    title: "ship it",
-    description: "build check passes, search is live with your real data"
-  }
-];
+// src/core/orchestrator.ts
+import "zod";
 
-// src/ui/Welcome.tsx
-import Image, { TerminalInfoContext, defaultTerminalInfo } from "ink-picture";
-import { jsx as jsx8, jsxs as jsxs9 } from "react/jsx-runtime";
-var IMAGE_PATH = join3(dirname2(fileURLToPath(import.meta.url)), "algolia.png");
-var TERMINAL_INFO = {
-  ...defaultTerminalInfo,
-  supportsUnicode: true,
-  supportsColor: true
-};
-function SidebarItem({
-  title,
-  description
-}) {
-  return /* @__PURE__ */ jsxs9(Box10, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs9(Box10, { gap: 1, children: [
-      /* @__PURE__ */ jsx8(Text10, { color: COLORS.success, children: "\u2192" }),
-      /* @__PURE__ */ jsx8(Text10, { color: COLORS.strong, bold: true, children: title })
-    ] }),
-    /* @__PURE__ */ jsxs9(Box10, { flexDirection: "row", gap: 2, children: [
-      /* @__PURE__ */ jsx8(Spacer, {}),
-      /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: description })
-    ] })
-  ] });
-}
-function Welcome() {
-  const confirmStart = useWizard((s) => s.confirmStart);
-  const openLearnMore = useWizard((s) => s.openLearnMore);
-  const { rows } = useWindowSize5();
-  const actions = [
-    { label: "start wizard", run: confirmStart },
-    { label: "learn more", run: openLearnMore }
-  ];
-  const [index, setIndex] = useState7(0);
-  useInput3((input, key) => {
-    if (key.upArrow || input === "k") {
-      setIndex((i) => (i - 1 + actions.length) % actions.length);
-    } else if (key.downArrow || input === "j") {
-      setIndex((i) => (i + 1) % actions.length);
-    } else if (key.return) {
-      actions[index].run();
-    }
-  });
-  const scales = {
-    large: {
-      sidebar: { padding: { x: 4, y: 2 }, gap: 2 },
-      main: { padding: { x: 8, y: 4 } }
-    },
-    small: {
-      sidebar: { padding: { x: 2, y: 1 }, gap: 1 },
-      main: { padding: { x: 4, y: 2 } }
-    }
-  };
-  let layout = scales["large"];
-  if (rows < 30) {
-    layout = scales["small"];
+// src/core/config.ts
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join as join3 } from "node:path";
+var configFile = () => join3(stateDir(), "config.json");
+var defaultConfig = () => ({
+  version: 1,
+  aiConsent: false,
+  workflowsRun: []
+});
+async function loadConfig() {
+  try {
+    const raw = await readFile(configFile(), "utf8");
+    return { ...defaultConfig(), ...JSON.parse(raw) };
+  } catch {
+    return defaultConfig();
   }
-  return /* @__PURE__ */ jsxs9(Box10, { flexDirection: "row", justifyContent: "space-between", width: "100%", children: [
-    /* @__PURE__ */ jsx8(
-      Box10,
-      {
-        paddingY: layout.main.padding.y,
-        paddingX: layout.main.padding.x,
-        flexDirection: "column",
-        justifyContent: "center",
-        children: /* @__PURE__ */ jsxs9(Box10, { flexDirection: "column", gap: 2, children: [
-          /* @__PURE__ */ jsx8(TerminalInfoContext.Provider, { value: TERMINAL_INFO, children: /* @__PURE__ */ jsx8(
-            Image,
-            {
-              src: IMAGE_PATH,
-              objectFit: "contain",
-              alt: "Algolia",
-              width: 20,
-              height: 10,
-              protocol: "halfBlock"
-            }
-          ) }),
-          /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: "\u2726 From zero \u2192 working search in ~10 minutes" }),
-          /* @__PURE__ */ jsx8(Box10, { flexDirection: "column", children: actions.map((action, i) => /* @__PURE__ */ jsx8(
-            SelectRow,
-            {
-              highlighted: i === index,
-              highlightBackground: false,
-              label: action.label
-            },
-            action.label
-          )) }),
-          /* @__PURE__ */ jsxs9(Box10, { gap: 2, children: [
-            /* @__PURE__ */ jsxs9(Text10, { children: [
-              /* @__PURE__ */ jsx8(Text10, { color: COLORS.primary, children: "[\u2191] [\u2193]" }),
-              /* @__PURE__ */ jsx8(Text10, { color: COLORS.dim, children: " move" })
-            ] }),
-            /* @__PURE__ */ jsxs9(Text10, { children: [
-              /* @__PURE__ */ jsx8(Text10, { color: COLORS.primary, children: "[enter]" }),
-              /* @__PURE__ */ jsx8(Text10, { color: COLORS.dim, children: " confirm" })
-            ] })
-          ] })
-        ] })
-      }
-    ),
-    /* @__PURE__ */ jsxs9(
-      Box10,
-      {
-        backgroundColor: COLORS.bg.sidebar,
-        width: 40,
-        paddingY: layout.sidebar.padding.y,
-        paddingX: layout.sidebar.padding.x,
-        gap: layout.sidebar.gap,
-        flexDirection: "column",
-        justifyContent: "center",
-        children: [
-          /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: "WHAT THIS WIZARD WILL DO" }),
-          sidebarItems.map((i, idx) => /* @__PURE__ */ jsx8(SidebarItem, { title: i.title, description: i.description }, idx))
-        ]
-      }
-    )
-  ] });
+}
+async function saveConfig(config) {
+  await mkdir(stateDir(), { recursive: true });
+  await writeFile(configFile(), JSON.stringify(config, null, 2), "utf8");
+}
+async function recordWorkflowRun(workflowId, completedAt) {
+  const config = await loadConfig();
+  config.workflowsRun.push({ workflowId, completedAt });
+  await saveConfig(config);
 }
 
-// src/ui/LearnMore.tsx
-import { Fragment } from "react";
-import { Box as Box11, Text as Text11, useInput as useInput4, useWindowSize as useWindowSize6 } 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.";
-var accessItems = [
-  {
-    tag: "READ",
-    title: "Project files",
-    description: "reads manifests, configs & source to detect your stack. Read-only; nothing is uploaded."
-  },
-  {
-    tag: "WRITE",
-    title: "Code changes",
-    description: "creates & edits files (search UI, config) directly in your branch."
-  },
-  {
-    tag: "EXEC",
-    title: "Setup commands",
-    description: "runs dependency installs, the ingestion script & your own checks. Every command is shown in full and needs your OK; its output is shown as-is, so a command that prints a secret will display it."
-  },
-  {
-    tag: "NET",
-    title: "Algolia API",
-    description: "sends index settings & the records you pick to your Algolia app over HTTPS."
-  },
-  {
-    tag: "KEY",
-    title: "Credentials",
-    description: "writes your Algolia app id and a search-only key (safe to expose) to .env in your project."
+// src/core/persistence.ts
+import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2, rm } from "node:fs/promises";
+import { join as join4 } from "node:path";
+var isStepVisible = (s) => s.visible !== false;
+var stateFile = (workflowId) => join4(stateDir(), `state-${workflowId}.json`);
+async function loadWorkflowState(workflowId) {
+  try {
+    const raw = await readFile2(stateFile(workflowId), "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
   }
-];
-var neverItems = [
-  "Send your source code to a model or third party",
-  "Commit or push to git",
-  "Run a command you haven't approved"
-];
-var policyLinks = [
-  { label: "Terms", url: "https://www.algolia.com/policies/terms" },
-  { label: "Privacy Policy", url: "https://www.algolia.com/policies/privacy" }
-];
+}
+async function saveWorkflowState(state) {
+  await mkdir2(stateDir(), { recursive: true });
+  await writeFile2(
+    stateFile(state.workflowId),
+    JSON.stringify(state, null, 2),
+    "utf8"
+  );
+}
+async function clearWorkflowState(workflowId) {
+  await rm(stateFile(workflowId), { force: true });
+}
 
-// src/ui/LearnMore.tsx
-import { jsx as jsx9, jsxs as jsxs10 } from "react/jsx-runtime";
-var TAG_COLORS = {
-  READ: COLORS.success,
-  WRITE: COLORS.badge,
-  EXEC: COLORS.danger,
-  NET: COLORS.accent,
-  KEY: COLORS.muted
-};
-var TAG_COLUMN_WIDTH = 10;
-var PADDING_X = 6;
-var NEVER_BOX_PAD_X = 2;
-function NeverLine({
-  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__ */ jsxs10(Text11, { color: COLORS.primary, children: [
-    /* @__PURE__ */ jsx9(Text11, { color: COLORS.danger, children: "\u2502" }),
-    " ".repeat(NEVER_BOX_PAD_X),
-    segments.map((s, i) => /* @__PURE__ */ jsx9(Text11, { color: s.color, bold: s.bold, children: s.text }, i)),
-    " ".repeat(rightPad),
-    /* @__PURE__ */ jsx9(Text11, { color: COLORS.danger, children: "\u2502" })
-  ] });
+// src/lib/telemetry.ts
+function isTelemetryOptedOut() {
+  return process.env.WIZARD_TELEMETRY === "false";
 }
-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);
-  useInput4((_input, key) => {
-    if (key.escape) backToHome();
-    else if (key.return) confirmStart();
-  });
-  return /* @__PURE__ */ jsxs10(
-    Box11,
-    {
-      flexDirection: "column",
-      paddingX: PADDING_X,
-      paddingY: 2,
-      width: "100%",
-      gap: 1,
-      children: [
-        /* @__PURE__ */ jsx9(Text11, { color: COLORS.strong, bold: true, children: "What algolia wizard accesses" }),
-        /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: accessIntro }),
-        /* @__PURE__ */ jsx9(Box11, { flexDirection: "column", children: accessItems.map((item) => /* @__PURE__ */ jsxs10(Box11, { flexDirection: "column", marginTop: 1, children: [
-          /* @__PURE__ */ jsx9(Text11, { color: COLORS.border, children: "\u2500".repeat(dividerWidth) }),
-          /* @__PURE__ */ jsxs10(Box11, { flexDirection: "row", gap: 1, marginTop: 1, children: [
-            /* @__PURE__ */ jsx9(Box11, { width: TAG_COLUMN_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx9(Text11, { color: TAG_COLORS[item.tag], bold: true, children: `[${item.tag}]` }) }),
-            /* @__PURE__ */ jsx9(Box11, { flexDirection: "column", children: /* @__PURE__ */ jsxs10(Text11, { color: COLORS.primary, children: [
-              /* @__PURE__ */ jsx9(Text11, { color: COLORS.strong, bold: true, children: item.title }),
-              /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: ` \u2014 ${item.description}` })
-            ] }) })
-          ] })
-        ] }, item.tag)) }),
-        /* @__PURE__ */ jsxs10(Box11, { marginTop: 1, flexDirection: "column", children: [
-          /* @__PURE__ */ jsx9(Text11, { color: COLORS.danger, children: `\u256D${"\u2500".repeat(Math.max(0, dividerWidth - 2))}\u256E` }),
-          /* @__PURE__ */ jsx9(NeverLine, { width: dividerWidth }),
-          /* @__PURE__ */ jsx9(
-            NeverLine,
-            {
-              width: dividerWidth,
-              segments: [{ text: "I NEVER", color: COLORS.danger, bold: true }]
-            }
-          ),
-          neverItems.map((item) => /* @__PURE__ */ jsxs10(Fragment, { children: [
-            /* @__PURE__ */ jsx9(NeverLine, { width: dividerWidth }),
-            /* @__PURE__ */ jsx9(
-              NeverLine,
-              {
-                width: dividerWidth,
-                segments: [
-                  { text: "\u2715", color: COLORS.danger },
-                  { text: " " },
-                  { text: item, color: COLORS.primary }
-                ]
-              }
-            )
-          ] }, item)),
-          /* @__PURE__ */ jsx9(NeverLine, { width: dividerWidth }),
-          /* @__PURE__ */ jsx9(Text11, { color: COLORS.danger, children: `\u2570${"\u2500".repeat(Math.max(0, dividerWidth - 2))}\u256F` })
-        ] }),
-        /* @__PURE__ */ jsx9(Box11, { marginTop: 1, flexDirection: "column", children: policyLinks.map((link) => /* @__PURE__ */ jsxs10(Box11, { flexDirection: "row", gap: 1, children: [
-          /* @__PURE__ */ jsx9(Text11, { color: COLORS.strong, bold: true, children: `${link.label}:` }),
-          /* @__PURE__ */ jsx9(Text11, { color: COLORS.accent, children: link.url })
-        ] }, link.label)) }),
-        /* @__PURE__ */ jsxs10(Box11, { marginTop: 1, flexDirection: "row", gap: 3, children: [
-          /* @__PURE__ */ jsxs10(Box11, { flexDirection: "row", gap: 1, children: [
-            /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: "[" }),
-            /* @__PURE__ */ jsx9(Text11, { color: COLORS.primary, children: "esc" }),
-            /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: "] back" })
-          ] }),
-          /* @__PURE__ */ jsxs10(Box11, { flexDirection: "row", gap: 1, children: [
-            /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: "[" }),
-            /* @__PURE__ */ jsx9(Text11, { color: COLORS.primary, children: "enter" }),
-            /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: "]" }),
-            /* @__PURE__ */ jsx9(Text11, { color: COLORS.success, bold: true, children: "start wizard" })
-          ] })
-        ] })
-      ]
-    }
-  );
+function isTelemetryEnabled() {
+  return Boolean(getAuthToken()) && !process.env.VITEST && !isTelemetryOptedOut();
 }
-
-// src/ui/Sidebar.tsx
-import { Box as Box14, Text as Text14 } from "ink";
-
-// src/ui/Steps.tsx
-import { Box as Box12, Text as Text12 } from "ink";
-import Spinner from "ink-spinner";
-
-// src/core/persistence.ts
-import { mkdir, readFile, writeFile, rm } from "node:fs/promises";
-import { join as join4 } from "node:path";
-var isStepVisible = (s) => s.visible !== false;
-var stateFile = (workflowId) => join4(stateDir(), `state-${workflowId}.json`);
-async function loadWorkflowState(workflowId) {
-  try {
-    const raw = await readFile(stateFile(workflowId), "utf8");
-    return JSON.parse(raw);
-  } catch {
-    return null;
-  }
+function fireAndForget(promise) {
+  void promise.catch(() => {
+  });
 }
-async function saveWorkflowState(state) {
-  await mkdir(stateDir(), { recursive: true });
-  await writeFile(
-    stateFile(state.workflowId),
-    JSON.stringify(state, null, 2),
-    "utf8"
+function sendTelemetry(payload) {
+  if (!isTelemetryEnabled()) return;
+  const token = getAuthToken();
+  if (!token) return;
+  const body = {
+    env: process.env.DD_ENV ?? "development",
+    ...payload
+  };
+  fireAndForget(
+    proxyFetch(`${PROXY_BASE_URL}/telemetry`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify(body)
+    }).then((res) => {
+      if (!res.ok) {
+        throw new Error(`Proxy telemetry ${res.status}`);
+      }
+    })
   );
 }
-async function clearWorkflowState(workflowId) {
-  await rm(stateFile(workflowId), { force: true });
+function sendLog(status, message, attributes = {}, tags = []) {
+  sendTelemetry({
+    logs: [{ status, message, attributes, tags }]
+  });
 }
-
-// src/ui/Steps.tsx
-import { jsx as jsx10, jsxs as jsxs11 } from "react/jsx-runtime";
-function Steps() {
-  const { steps } = useWizard();
-  const visibleSteps = steps.filter(isStepVisible);
-  return /* @__PURE__ */ jsx10(Box12, { flexDirection: "column", gap: 1, children: visibleSteps.map((s) => /* @__PURE__ */ jsx10(Box12, { flexDirection: "column", children: /* @__PURE__ */ jsxs11(Text12, { color: COLORS.status[s.status], children: [
-    s.status === "running" ? /* @__PURE__ */ jsx10(Spinner, { type: "dots" }) : MARKER[s.status],
-    " ",
-    s.title
-  ] }) }, s.id)) });
+function sendMetric(name, value, type, tags = []) {
+  sendTelemetry({
+    metrics: [{ name, value, type, tags }]
+  });
 }
-function CurrentStep() {
-  const { steps } = useWizard();
-  const currentStep = steps.filter(isStepVisible).find((s) => s.status === "running");
-  if (!currentStep) return null;
-  return /* @__PURE__ */ jsxs11(Text12, { color: COLORS.status.running, children: [
-    /* @__PURE__ */ jsx10(Spinner, { type: "dots" }),
-    " ",
-    ` ${currentStep.title}`
-  ] });
+function metricTags(workflowId, actionId) {
+  return actionId ? [`workflow:${workflowId}`, `action:${actionId}`] : [`workflow:${workflowId}`];
 }
-
-// src/ui/Progress.tsx
-import { Box as Box13, Text as Text13 } from "ink";
-import { jsx as jsx11, jsxs as jsxs12 } 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__ */ jsxs12(Box13, { flexDirection: "row", gap: 1, children: [
-    /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: "STEP" }),
-    /* @__PURE__ */ jsx11(Text13, { color: COLORS.strong, bold: true, children: activeStepNumber }),
-    /* @__PURE__ */ jsx11(Text13, { color: COLORS.strong, bold: true, children: "/" }),
-    /* @__PURE__ */ jsx11(Text13, { color: COLORS.strong, bold: true, children: visibleSteps.length })
-  ] });
+function logTags(workflowId, actionId, appId) {
+  return [
+    ...metricTags(workflowId, actionId),
+    ...appId ? [`app_id:${appId}`] : []
+  ];
 }
-
-// src/ui/copy/sidebar-commands.ts
-var sidebarCommands = [
-  { keyHint: "tab", description: "toggle logs" },
-  { keyHint: "esc", description: "exit wizard" }
-];
-
-// src/ui/Sidebar.tsx
-import { jsx as jsx12, jsxs as jsxs13 } from "react/jsx-runtime";
-function Sidebar() {
-  return /* @__PURE__ */ jsxs13(
-    Box14,
-    {
-      backgroundColor: "#14171E",
-      width: 30,
-      paddingX: 4,
-      paddingY: 2,
-      flexDirection: "column",
-      justifyContent: "space-between",
-      children: [
-        /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", gap: 1, children: [
-          /* @__PURE__ */ jsx12(Text14, { color: COLORS.muted, children: "PROGRESS" }),
-          /* @__PURE__ */ jsx12(Steps, {})
-        ] }),
-        /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", gap: 1, children: [
-          /* @__PURE__ */ jsx12(Progress, {}),
-          /* @__PURE__ */ jsx12(Box14, { flexDirection: "column", children: sidebarCommands.map((c) => {
-            return /* @__PURE__ */ jsxs13(Box14, { flexDirection: "row", gap: 1, children: [
-              /* @__PURE__ */ jsx12(Text14, { color: COLORS.primary, children: `[${c.keyHint}]` }),
-              /* @__PURE__ */ jsx12(Text14, { color: COLORS.muted, children: c.description })
-            ] });
-          }) })
-        ] })
-      ]
-    }
-  );
+function emitTelemetryLog(level, message, attributes, tags) {
+  if (level === "info") {
+    logger.info(attributes, message);
+  } else {
+    logger.error(attributes, message);
+  }
+  sendLog(level, message, attributes, tags);
 }
-
-// src/ui/Ribbon.tsx
-import { Box as Box15, Text as Text15 } from "ink";
-import { jsx as jsx13, jsxs as jsxs14 } from "react/jsx-runtime";
-function Ribbon() {
-  const firstCommand = sidebarCommands[0];
-  return /* @__PURE__ */ jsxs14(
-    Box15,
-    {
-      backgroundColor: "#14171E",
-      flexDirection: "row",
-      justifyContent: "space-between",
-      paddingX: 2,
-      paddingY: 1,
-      children: [
-        /* @__PURE__ */ jsx13(Progress, {}),
-        /* @__PURE__ */ jsx13(CurrentStep, {}),
-        /* @__PURE__ */ jsxs14(Box15, { flexDirection: "row", gap: 1, children: [
-          /* @__PURE__ */ jsx13(Text15, { color: COLORS.primary, children: `[${firstCommand.keyHint}]` }),
-          /* @__PURE__ */ jsx13(Text15, { color: COLORS.muted, children: firstCommand.description })
-        ] })
-      ]
-    }
+function trackWorkflowStart(ctx) {
+  const attributes = {
+    event: "wizard.workflow.start",
+    workflow_id: ctx.workflowId,
+    app_id: ctx.appId
+  };
+  emitTelemetryLog(
+    "info",
+    "wizard workflow started",
+    attributes,
+    logTags(ctx.workflowId, void 0, ctx.appId)
   );
-}
-
-// src/ui/App.tsx
-import { useState as useState9 } from "react";
-
-// src/ui/Logs.tsx
-import { Box as Box16, Text as Text16, useInput as useInput5 } from "ink";
-import { jsx as jsx14, jsxs as jsxs15 } from "react/jsx-runtime";
-var KIND_COLOR = {
-  tool: COLORS.primary,
-  prompt: COLORS.badge
-};
-var STATUS_COLOR = {
-  running: COLORS.status.running,
-  error: COLORS.danger
-};
-function logNameColor(entry) {
-  return STATUS_COLOR[entry.status] ?? KIND_COLOR[entry.kind];
-}
-var ROW_GAP = 1;
-function truncate2(str, maxWidth) {
-  if (maxWidth <= 0) return "";
-  return str.length > maxWidth ? `${str.slice(0, maxWidth - 1)}\u2026` : str;
-}
-function rawInputText(input) {
-  if (input === void 0) return "";
-  const str = typeof input === "string" ? input : JSON.stringify(input);
-  if (!str || str === "{}") return "";
-  return str.replace(/\s+/g, " ").trim();
-}
-function formatTimestamp(ms) {
-  const d = new Date(ms);
-  const pad = (n) => String(n).padStart(2, "0");
-  return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
-}
-function Logs() {
-  const logs = useWizard((s) => s.logs);
-  const scroll = useScrollWindow({ itemCount: logs.length, followBottom: true });
-  useInput5((_input, key) => {
-    if (key.upArrow) scroll.scrollBy(-1);
-    else if (key.downArrow) scroll.scrollBy(1);
-  });
-  const visible = logs.slice(scroll.offset, scroll.offset + scroll.capacity);
-  return /* @__PURE__ */ jsxs15(Box16, { flexDirection: "column", paddingX: 4, paddingY: 2, flexGrow: 1, children: [
-    logs.length === 0 && /* @__PURE__ */ jsx14(Text16, { color: COLORS.dim, children: "No logs yet." }),
-    /* @__PURE__ */ jsx14(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);
-      const partCount = 2 + (rawPreview ? 1 : 0) + (durationText ? 1 : 0);
-      const gaps = (partCount - 1) * ROW_GAP;
-      let budget = scroll.width - timestamp.length - durationText.length - gaps;
-      const name = truncate2(entry.name, budget);
-      budget -= name.length;
-      const preview = rawPreview ? truncate2(rawPreview, budget) : "";
-      return /* @__PURE__ */ jsxs15(Box16, { flexDirection: "row", gap: ROW_GAP, children: [
-        /* @__PURE__ */ jsx14(Text16, { color: COLORS.dim, children: timestamp }),
-        /* @__PURE__ */ jsx14(Text16, { color: logNameColor(entry), wrap: "truncate", children: name }),
-        preview && /* @__PURE__ */ jsx14(Text16, { color: COLORS.dim, wrap: "truncate", children: preview }),
-        durationText && /* @__PURE__ */ jsx14(Text16, { color: COLORS.dim, children: durationText })
-      ] }, entry.id);
-    }) }),
-    /* @__PURE__ */ jsx14(Text16, { color: COLORS.dim, children: "\u2191/\u2193 scroll" })
-  ] });
-}
-
-// src/lib/events.ts
-import "zod";
-
-// src/lib/telemetry.ts
-function isTelemetryOptedOut() {
-  return process.env.WIZARD_TELEMETRY === "false";
-}
-function isTelemetryEnabled() {
-  return Boolean(getAuthToken()) && !process.env.VITEST && !isTelemetryOptedOut();
-}
-function fireAndForget(promise) {
-  void promise.catch(() => {
-  });
-}
-function sendTelemetry(payload) {
-  if (!isTelemetryEnabled()) return;
-  const token = getAuthToken();
-  if (!token) return;
-  const body = {
-    env: process.env.DD_ENV ?? "development",
-    ...payload
-  };
-  fireAndForget(
-    proxyFetch(`${PROXY_BASE_URL}/telemetry`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        authorization: `Bearer ${token}`
-      },
-      body: JSON.stringify(body)
-    }).then((res) => {
-      if (!res.ok) {
-        throw new Error(`Proxy telemetry ${res.status}`);
-      }
-    })
-  );
-}
-function sendLog(status, message, attributes = {}, tags = []) {
-  sendTelemetry({
-    logs: [{ status, message, attributes, tags }]
-  });
-}
-function sendMetric(name, value, type, tags = []) {
-  sendTelemetry({
-    metrics: [{ name, value, type, tags }]
-  });
-}
-function metricTags(workflowId, actionId) {
-  return actionId ? [`workflow:${workflowId}`, `action:${actionId}`] : [`workflow:${workflowId}`];
-}
-function logTags(workflowId, actionId, appId) {
-  return [
-    ...metricTags(workflowId, actionId),
-    ...appId ? [`app_id:${appId}`] : []
-  ];
-}
-function emitTelemetryLog(level, message, attributes, tags) {
-  if (level === "info") {
-    logger.info(attributes, message);
-  } else {
-    logger.error(attributes, message);
-  }
-  sendLog(level, message, attributes, tags);
-}
-function trackWorkflowStart(ctx) {
-  const attributes = {
-    event: "wizard.workflow.start",
-    workflow_id: ctx.workflowId,
-    app_id: ctx.appId
-  };
-  emitTelemetryLog(
-    "info",
-    "wizard workflow started",
-    attributes,
-    logTags(ctx.workflowId, void 0, ctx.appId)
-  );
-  sendMetric("wizard.workflow.invocation", 1, 1, metricTags(ctx.workflowId));
+  sendMetric("wizard.workflow.invocation", 1, 1, metricTags(ctx.workflowId));
 }
 function trackActionStart(ctx) {
   const attributes = {
@@ -1783,6 +1351,7 @@ function trackWorkflowError(ctx) {
 }
 
 // src/lib/events.ts
+import "zod";
 function track(event, payload) {
   if (isTelemetryOptedOut()) return;
   const token = getAuthToken();
@@ -1801,514 +1370,81 @@ function track(event, payload) {
   });
 }
 
-// src/ui/Tips.tsx
-import { useEffect as useEffect3, useState as useState8 } from "react";
-import { Box as Box18, Text as Text18 } from "ink";
-import terminalLink from "terminal-link";
-
-// src/ui/Code.tsx
-import { Box as Box17, Text as Text17 } from "ink";
-import { jsx as jsx15 } 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);
-  return parts.map((part, i) => {
-    if (!part) return null;
-    if (part[0] === '"') {
-      const next = parts.slice(i + 1).find((p) => p.trim());
-      const isKey = next?.trimStart().startsWith(":");
-      return /* @__PURE__ */ jsx15(Text17, { color: isKey ? "cyan" : "green", children: part }, i);
-    }
-    if (part === "true" || part === "false" || part === "null") {
-      return /* @__PURE__ */ jsx15(Text17, { color: "magenta", children: part }, i);
-    }
-    if (/^-?\d/.test(part)) {
-      return /* @__PURE__ */ jsx15(Text17, { color: "yellow", children: part }, i);
-    }
-    if (/^[{}[\]:,]$/.test(part)) {
-      return /* @__PURE__ */ jsx15(Text17, { dimColor: true, children: part }, i);
-    }
-    return /* @__PURE__ */ jsx15(Text17, { children: part }, i);
-  });
+// src/core/orchestrator.ts
+function defineStep(step) {
+  return { visible: true, ...step };
 }
-function Code({ children }) {
-  return /* @__PURE__ */ jsx15(Box17, { children: /* @__PURE__ */ jsx15(Text17, { children: highlightJson(children) }) });
+var nowIso = () => (/* @__PURE__ */ new Date()).toISOString();
+function ensureExecutedStepCount(state) {
+  if (state.executedStepCount == null) {
+    state.executedStepCount = state.steps.filter(
+      (s) => s.status === "done" && isStepVisible(s)
+    ).length;
+  }
 }
-
-// src/ui/copy/tips.ts
-var tips = [
-  {
-    title: "An Application is like your library. Indices are the books in it.",
-    chunks: [
-      {
-        type: "text",
-        value: "Applications hold your API keys and Indices."
-      },
-      {
-        type: "text",
-        value: "Each index is a searchable collection of records (think: products, articles, orders, concerts)."
-      }
-    ]
-  },
-  {
-    title: "A Record is a JSON object inside of an index.",
-    chunks: [
-      {
-        type: "text",
-        value: "Every object you index is just a JSON document with a unique objectID."
-      },
-      {
-        type: "text",
-        value: "No fixed schema, no hard requirements."
-      },
-      {
-        type: "text",
-        value: "Everything else is up to you:"
-      },
-      {
-        type: "code",
-        value: JSON.stringify(
-          {
-            objectID: "sku_48213",
-            name: "Trail Running Shoe",
-            brand: "Northline",
-            categories: ["Footwear", "Running", "Mens"],
-            price: 129.99,
-            in_stock: true,
-            rating: 4.6
-          },
-          null,
-          2
-        )
+function reconcileWorkflowState(state, workflow) {
+  const persistedIds = state.steps.map((s) => s.id).join("\n");
+  const definedIds = workflow.steps.map((s) => s.id).join("\n");
+  if (persistedIds !== definedIds) return null;
+  for (let i = 0; i < state.steps.length; i++) {
+    const record = state.steps[i];
+    const step = workflow.steps[i];
+    if (record.status === "done") {
+      const parsed = step.outputSchema.safeParse(record.output);
+      if (!parsed.success) {
+        logger.warn(
+          { stepId: step.id, issues: parsed.error.issues },
+          "reconcileWorkflowState: persisted output for a completed step no longer matches its schema; restarting the run from scratch"
+        );
+        return null;
       }
-    ]
-  },
-  {
-    title: "Speed isn't a feature, it's our business",
-    chunks: [
-      {
-        type: "text",
-        value: "Algolia's engine processes most search queries in 1 to 50 milliseconds."
-      },
-      {
-        type: "text",
-        value: "This is why our search-as-you-type experience feels instant."
-      }
-    ]
-  },
-  {
-    title: "Searchable attributes are your relevance dial #1",
-    chunks: [
-      {
-        type: "text",
-        value: "Order matters. Attributes listed first in"
-      },
-      { type: "codeword", value: "searchableAttributes" },
-      { type: "text", value: "carry more ranking weight." },
-      {
-        type: "text",
-        value: "This is the single highest-leverage lever new users don't know exists."
-      }
-    ]
-  },
-  {
-    title: "Facets aren't just filters, they help build your UI",
-    chunks: [
-      { type: "codeword", value: "attributesForFaceting" },
-      {
-        type: "text",
-        value: "unlock category sidebars, price sliders, tag clouds without extra backend work."
-      }
-    ]
-  },
-  {
-    title: "Test relevance in the dashboard before you write a line of ranking code",
-    chunks: [
-      {
-        type: "text",
-        value: "Our Search dashboard has a live preview where you can browse results."
-      },
-      {
-        type: "text",
-        value: "Tune your settings and see how it alters your results in"
-      },
-      {
-        type: "link",
-        value: "real-time.",
-        href: "https://dashboard.algolia.com/explorer/browse"
-      }
-    ]
-  },
-  {
-    title: "Search Analytics helps you discover opportunities",
-    chunks: [
-      {
-        type: "text",
-        value: "No click results for a particular query? Low click-through rates for another?"
-      },
-      {
-        type: "text",
-        value: "Our Search Analytics will help you identify synonyms, rules or other relevancy settings to improve your results."
-      }
-    ]
-  },
-  {
-    title: "Let Algolia act as your recommendation engine",
-    chunks: [
-      {
-        type: "text",
-        value: "Beyond search, Algolia Recommend runs models trained on your existing indices and event data to power your recommendation engine."
-      },
-      {
-        type: "text",
-        value: "You can improve engagement with related, popular or visually similar items."
-      }
-    ]
+    }
+    record.title = step.title;
+    record.visible = step.visible;
   }
-];
-
-// src/ui/Tips.tsx
-import { jsx as jsx16, jsxs as jsxs16 } from "react/jsx-runtime";
-var TICK_MS = 16;
-var CHUNK_HOLD_MS = 2e3;
-var HOLD_MS = 8e3;
-function TipTitle({ children }) {
-  return /* @__PURE__ */ jsxs16(Box18, { gap: 1, children: [
-    /* @__PURE__ */ jsx16(Text18, { color: "cyan", children: "\u2726" }),
-    /* @__PURE__ */ jsx16(Text18, { color: "white", bold: true, children })
-  ] });
+  return state;
 }
-function InlineSegment({ segment }) {
-  switch (segment.type) {
-    case "highlight":
-      return /* @__PURE__ */ jsx16(Text18, { color: COLORS.success, children: segment.value });
-    case "link":
-      return /* @__PURE__ */ jsx16(Text18, { color: "cyan", underline: true, children: segment.href ? terminalLink(segment.value, segment.href) : segment.value });
-    case "codeword":
-      return /* @__PURE__ */ jsx16(Text18, { color: COLORS.highlight.fg, backgroundColor: COLORS.highlight.bg, children: segment.value });
-    default:
-      return /* @__PURE__ */ jsx16(Text18, { color: COLORS.muted, children: segment.value });
-  }
+function initWorkflowState(workflow, now) {
+  return {
+    workflowId: workflow.id,
+    startedAt: now,
+    updatedAt: now,
+    currentStepIndex: 0,
+    steps: workflow.steps.map((s) => ({
+      id: s.id,
+      title: s.title,
+      visible: s.visible,
+      status: "pending"
+    })),
+    algoliaState: {},
+    userInputs: {}
+  };
 }
-function TipContent({
-  chunks,
-  revealed
-}) {
-  let remaining = revealed;
-  const slices = chunks.map((chunk) => {
-    const slice = chunk.value.slice(0, Math.max(0, remaining));
-    remaining -= chunk.value.length;
-    return slice;
+async function ensureConsent() {
+  const config = await loadConfig();
+  if (config.aiConsent) return;
+  const store = useWizard.getState();
+  const answer = await store.requestUserInput({
+    prompt: "Wizard will make AI-authored changes to this repository, and will propose shell commands to set it up. You approve each command before it runs.",
+    promptType: "enterToContinue",
+    options: []
   });
-  const blocks = [];
-  for (let i = 0; i < chunks.length; i++) {
-    const chunk = chunks[i];
-    const slice = slices[i];
-    if (!slice) continue;
-    const segment = {
-      type: chunk.type,
-      value: slice,
-      href: chunk.type === "link" ? chunk.href : void 0
-    };
-    if (chunk.type === "code") {
-      blocks.push({ type: "code", segment });
-      continue;
-    }
-    const last = blocks[blocks.length - 1];
-    if (last?.type === "inline") {
-      last.segments.push(segment);
-    } else {
-      blocks.push({ type: "inline", segments: [segment] });
-    }
-  }
-  return /* @__PURE__ */ jsx16(Box18, { flexDirection: "column", marginLeft: 2, gap: 1, children: blocks.map(
-    (block, i) => block.type === "code" ? /* @__PURE__ */ jsx16(Code, { children: block.segment.value }, i) : /* @__PURE__ */ jsx16(Text18, { children: block.segments.map((segment, j) => /* @__PURE__ */ jsxs16(Text18, { children: [
-      j > 0 && " ",
-      /* @__PURE__ */ jsx16(InlineSegment, { segment })
-    ] }, j)) }, i)
-  ) });
-}
-function Tips() {
-  const [tipIndex, setTipIndex] = useState8(0);
-  const [revealed, setRevealed] = useState8(0);
-  const tip = tips[tipIndex];
-  const contentLength = tip.chunks.reduce((sum, c) => sum + c.value.length, 0);
-  const totalLength = tip.title.length + contentLength;
-  const segments = [
-    { type: "title", length: tip.title.length },
-    ...tip.chunks.map((c) => ({ type: c.type, length: c.value.length }))
-  ];
-  const noPauseAfterText = [
-    "highlight",
-    "link",
-    "codeword"
-  ];
-  const chunkBoundaries = [];
-  let cumulative = 0;
-  for (let i = 0; i < segments.length - 1; i++) {
-    cumulative += segments[i].length;
-    const skipPause = noPauseAfterText.includes(
-      segments[i + 1].type
+  if (answer !== true) {
+    throw new Error(
+      "AI consent declined \u2014 cannot proceed. If you change your mind, just run the Wizard again!"
     );
-    if (!skipPause) chunkBoundaries.push(cumulative);
   }
-  useEffect3(() => {
-    if (revealed < totalLength) {
-      const delay2 = chunkBoundaries.includes(revealed) ? CHUNK_HOLD_MS : TICK_MS;
-      const timer2 = setTimeout(() => setRevealed((r) => r + 1), delay2);
-      return () => clearTimeout(timer2);
-    }
-    const timer = setTimeout(() => {
-      setTipIndex((i) => {
-        if (i < tips.length - 1) return i + 1;
-        return 0;
-      });
-      setRevealed(0);
-    }, HOLD_MS);
-    return () => clearTimeout(timer);
-  }, [revealed, totalLength]);
-  const titleRevealed = tip.title.slice(0, revealed);
-  const contentRevealed = Math.max(0, revealed - tip.title.length);
-  return /* @__PURE__ */ jsxs16(Box18, { flexDirection: "column", marginBottom: 1, gap: 1, children: [
-    /* @__PURE__ */ jsx16(TipTitle, { children: titleRevealed }),
-    /* @__PURE__ */ jsx16(TipContent, { chunks: tip.chunks, revealed: contentRevealed })
-  ] });
+  config.aiConsent = true;
+  await saveConfig(config);
 }
-
-// src/ui/App.tsx
-import { jsx as jsx17, jsxs as jsxs17 } from "react/jsx-runtime";
-function App() {
-  const {
-    phase,
-    error,
-    homeScreen,
-    currentStepIndex,
-    steps,
-    inputReq,
-    user,
-    notices
-  } = useWizard();
-  const { exit } = useApp();
-  const { columns, rows } = useWindowSize7();
-  const [showLogs, setShowLogs] = useState9(false);
-  const finished = phase === "done" || phase === "error";
-  const currentStep = steps[currentStepIndex];
-  const isInitialAnalysisStep = currentStepIndex === 0;
-  const isAwaitingUserInput = phase === "awaitingInput" && !!inputReq;
-  const showTips = phase === "running" && isInitialAnalysisStep && notices.length > 0;
-  const showNoticesInMain = !isInitialAnalysisStep;
-  const showNotices = !isAwaitingUserInput;
-  useInput6(
-    (_input, key) => {
-      if (key.return) {
-        exit();
-      }
-    },
-    { isActive: finished }
-  );
-  useInput6((_input, key) => {
-    if (phase === "idle" || phase === "authenticating") return;
-    if (key.tab) {
-      setShowLogs(!showLogs);
-      track("AI Wizard Interaction", {
-        context: "global",
-        key: "tab",
-        currentStep: currentStep?.id
-      });
-    }
-  });
-  const escOwnedElsewhere = phase === "idle" || phase === "authenticating" || phase === "awaitingInput" && (inputReq?.promptType === "enterToContinue" || inputReq?.promptType === "commandApproval");
-  useInput6((_input, key) => {
-    if (escOwnedElsewhere) return;
-    if (key.escape) {
-      track("AI Wizard Interaction", {
-        context: "global",
-        key: "esc",
-        currentStep: currentStep?.id ?? phase
-      });
-      exit();
-    }
-  });
-  const mainWindowVisible = phase === "authenticating" || phase === "preflight" || phase === "running" || phase === "awaitingInput" || phase === "error" || phase === "done";
-  const flexDirection = columns > 90 ? "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__ */ jsxs17(
-      Box19,
-      {
-        backgroundColor: COLORS.bg.main,
-        flexDirection: "row",
-        width: columns,
-        height: scrollsPastViewport ? void 0 : rows,
-        overflow: scrollsPastViewport ? "visible" : "hidden",
-        children: [
-          mainWindowVisible && /* @__PURE__ */ jsxs17(
-            Box19,
-            {
-              flexDirection,
-              width: "100%",
-              maxHeight: rows,
-              justifyContent: "space-between",
-              children: [
-                showLogs ? /* @__PURE__ */ jsx17(Logs, {}) : /* @__PURE__ */ jsxs17(
-                  Box19,
-                  {
-                    flexDirection: "column",
-                    paddingX: 4,
-                    paddingY: 2,
-                    width: showSidebar ? 70 : "100%",
-                    flexGrow: 1,
-                    gap: 1,
-                    children: [
-                      /* @__PURE__ */ jsxs17(Box19, { flexGrow: 2, flexDirection: "column", children: [
-                        phase === "preflight" && !user && /* @__PURE__ */ jsx17(Box19, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs17(Text19, { color: COLORS.strong, bold: true, children: [
-                          /* @__PURE__ */ jsx17(Spinner2, { type: "dots" }),
-                          " Signing in to Algolia"
-                        ] }) }),
-                        phase === "preflight" && user && /* @__PURE__ */ jsx17(Box19, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs17(Text19, { color: COLORS.strong, bold: true, children: [
-                          /* @__PURE__ */ jsx17(Spinner2, { type: "dots" }),
-                          " Getting things ready"
-                        ] }) }),
-                        phase === "authenticating" && /* @__PURE__ */ jsxs17(Box19, { flexDirection: "column", marginBottom: 1, children: [
-                          /* @__PURE__ */ jsxs17(Text19, { color: COLORS.strong, bold: true, children: [
-                            /* @__PURE__ */ jsx17(Spinner2, { type: "dots" }),
-                            " Signing in to Algolia"
-                          ] }),
-                          /* @__PURE__ */ jsx17(Text19, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
-                        ] }),
-                        /* @__PURE__ */ jsx17(CliOutput, {}),
-                        showTips && /* @__PURE__ */ jsx17(Tips, {}),
-                        showNoticesInMain && showNotices && /* @__PURE__ */ jsx17(Notices, { showAll: true, border: false }),
-                        /* @__PURE__ */ jsx17(PromptInput, {}),
-                        phase === "error" && error && /* @__PURE__ */ jsx17(Box19, { marginTop: 1, children: /* @__PURE__ */ jsxs17(Text19, { color: COLORS.status.error, children: [
-                          "\u2716 ",
-                          error
-                        ] }) })
-                      ] }),
-                      !showNoticesInMain && showNotices && /* @__PURE__ */ jsx17(Notices, {})
-                    ]
-                  }
-                ),
-                showSidebar ? /* @__PURE__ */ jsx17(Sidebar, {}) : /* @__PURE__ */ jsx17(Ribbon, {})
-              ]
-            }
-          ),
-          phase === "idle" && (homeScreen === "learnMore" ? /* @__PURE__ */ jsx17(LearnMore, {}) : /* @__PURE__ */ jsx17(Welcome, {}))
-        ]
-      }
-    )
-  );
-}
-
-// src/core/orchestrator.ts
-import "zod";
-
-// src/core/config.ts
-import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join5 } from "node:path";
-var configFile = () => join5(stateDir(), "config.json");
-var defaultConfig = () => ({
-  version: 1,
-  aiConsent: false,
-  workflowsRun: []
-});
-async function loadConfig() {
-  try {
-    const raw = await readFile2(configFile(), "utf8");
-    return { ...defaultConfig(), ...JSON.parse(raw) };
-  } catch {
-    return defaultConfig();
-  }
-}
-async function saveConfig(config) {
-  await mkdir2(stateDir(), { recursive: true });
-  await writeFile2(configFile(), JSON.stringify(config, null, 2), "utf8");
-}
-async function recordWorkflowRun(workflowId, completedAt) {
-  const config = await loadConfig();
-  config.workflowsRun.push({ workflowId, completedAt });
-  await saveConfig(config);
-}
-
-// src/core/orchestrator.ts
-function defineStep(step) {
-  return { visible: true, ...step };
-}
-var nowIso = () => (/* @__PURE__ */ new Date()).toISOString();
-function ensureExecutedStepCount(state) {
-  if (state.executedStepCount == null) {
-    state.executedStepCount = state.steps.filter(
-      (s) => s.status === "done" && isStepVisible(s)
-    ).length;
-  }
-}
-function reconcileWorkflowState(state, workflow) {
-  const persistedIds = state.steps.map((s) => s.id).join("\n");
-  const definedIds = workflow.steps.map((s) => s.id).join("\n");
-  if (persistedIds !== definedIds) return null;
-  for (let i = 0; i < state.steps.length; i++) {
-    const record = state.steps[i];
-    const step = workflow.steps[i];
-    if (record.status === "done") {
-      const parsed = step.outputSchema.safeParse(record.output);
-      if (!parsed.success) {
-        logger.warn(
-          { stepId: step.id, issues: parsed.error.issues },
-          "reconcileWorkflowState: persisted output for a completed step no longer matches its schema; restarting the run from scratch"
-        );
-        return null;
-      }
-    }
-    record.title = step.title;
-    record.visible = step.visible;
-  }
-  return state;
-}
-function initWorkflowState(workflow, now) {
-  return {
-    workflowId: workflow.id,
-    startedAt: now,
-    updatedAt: now,
-    currentStepIndex: 0,
-    steps: workflow.steps.map((s) => ({
-      id: s.id,
-      title: s.title,
-      visible: s.visible,
-      status: "pending"
-    })),
-    algoliaState: {},
-    userInputs: {}
-  };
-}
-async function ensureConsent() {
-  const config = await loadConfig();
-  if (config.aiConsent) return;
-  const store = useWizard.getState();
-  const answer = await store.requestUserInput({
-    prompt: "Wizard will make AI-authored changes to this repository, and will propose shell commands to set it up. You approve each command before it runs.",
-    promptType: "enterToContinue",
-    options: []
-  });
-  if (answer !== true) {
-    throw new Error(
-      "AI consent declined \u2014 cannot proceed. If you change your mind, just run the Wizard again!"
-    );
-  }
-  config.aiConsent = true;
-  await saveConfig(config);
-}
-async function makeContext(state) {
-  const outputs = {};
-  const completedSteps = [];
-  for (const s of state.steps) {
-    if (s.status === "done") {
-      outputs[s.id] = s.output;
-      if (s.visible) {
-        completedSteps.push({ id: s.id, title: s.title, output: s.output });
+async function makeContext(state) {
+  const outputs = {};
+  const completedSteps = [];
+  for (const s of state.steps) {
+    if (s.status === "done") {
+      outputs[s.id] = s.output;
+      if (s.visible) {
+        completedSteps.push({ id: s.id, title: s.title, output: s.output });
       }
     }
   }
@@ -2448,219 +1584,20 @@ async function runWorkflow(workflow, appId) {
   }
 }
 
-// src/lib/algoliaApp.ts
+// src/actions/listIndices.ts
 import { z as z4 } from "zod";
-var applicationSchema = z4.object({
-  id: z4.string().min(1),
-  name: z4.string().default(""),
-  plan: z4.string().optional()
+var indicesListSchema = z4.object({
+  items: z4.array(
+    z4.object({
+      name: z4.string(),
+      entries: z4.number().default(0)
+    })
+  )
 });
-var listSchema = z4.array(
-  z4.object({
-    id: z4.string().min(1),
-    name: z4.string().default(""),
-    plan_label: z4.string().optional()
-  }).transform(({ id, name, plan_label }) => ({ id, name, plan: plan_label }))
-);
-async function currentApplication() {
-  let raw;
-  try {
-    raw = await runAlgoliaCli(["application", "current", "-o", "json"]);
-  } catch {
-    return null;
-  }
-  const parsed = applicationSchema.safeParse(parseJson(raw));
-  return parsed.success ? parsed.data : null;
-}
-async function requireApplication() {
-  const app = await currentApplication();
-  if (!app) {
-    throw new Error(
-      "No Algolia application is selected. Run `npx @algolia/cli@latest application select` and restart the wizard."
-    );
-  }
-  return app;
-}
-async function listApplications() {
-  const raw = await runAlgoliaCli(["application", "list", "-o", "json"]);
-  const parsed = listSchema.safeParse(parseJson(raw));
-  if (!parsed.success) {
-    throw new Error("Could not read the list of Algolia applications.");
-  }
-  return parsed.data;
-}
-async function selectApplication(id) {
-  const raw = await runAlgoliaCli(
-    ["application", "select", "--non-interactive", "--app-id", id],
-    { onOutput: stderrSink }
-  );
-  const parsed = applicationSchema.safeParse(parseJson(raw));
-  if (!parsed.success) {
-    throw new Error(
-      `Selected application ${id}, but the Algolia CLI returned an unreadable result.`
-    );
-  }
-  return parsed.data;
-}
-function parseJson(text) {
-  try {
-    return JSON.parse(text);
-  } catch {
-    return void 0;
-  }
-}
-
-// src/lib/envAppId.ts
-import { readFile as readFile3 } from "node:fs/promises";
-import { join as join6 } from "node:path";
-var ENV_FILES = [".env", ".env.local"];
-var APP_ID_LINE = /^[ \t]*(?:export[ \t]+)?([A-Z0-9_]*ALGOLIA_APP(?:LICATION)?_ID)[ \t]*=[ \t]*(.*)$/gm;
-async function findEnvApplicationId(root = process.cwd()) {
-  for (const file of ENV_FILES) {
-    let content;
-    try {
-      content = await readFile3(join6(root, file), "utf8");
-    } catch (err) {
-      if (err.code !== "ENOENT") {
-        logger.warn(
-          { file, err },
-          "could not read env file for an application id"
-        );
-      }
-      continue;
-    }
-    for (const [, name, raw] of content.matchAll(APP_ID_LINE)) {
-      const id = readValue(raw);
-      if (id) {
-        logger.info({ file, name, app: id }, "found an application id in env");
-        return { id, name, file };
-      }
-    }
-  }
-  return null;
-}
-function readValue(raw) {
-  const trimmed = raw.trim();
-  const quoted = trimmed.match(/^(['"])(.*)\1/);
-  const value = quoted ? quoted[2].trim() : trimmed.replace(/\s+#.*$/, "").trim();
-  return value.length > 0 && !value.startsWith("<") ? value : null;
-}
-
-// src/lib/algoliaAppPicker.ts
-function secondaryFor(app) {
-  return app.plan ? { kind: "badge", value: app.plan } : void 0;
-}
-function labelFor(app) {
-  return app.name.trim() ? `${app.name} \u2014 ${app.id}` : app.id;
-}
-function selectAndReport(app) {
-  useWizard.getState().pushCliOutput(
-    "stdout",
-    `Selecting ${labelFor(app)} \u2014 provisioning its API key\u2026`
-  );
-  return selectApplication(app.id);
-}
-async function promptForApplication(leadIn = []) {
-  const store = useWizard.getState();
-  const apps = await listApplications();
-  if (apps.length === 0) {
-    throw new Error(
-      "This Algolia account has no applications. Create one in the Algolia dashboard, or with `npx @algolia/cli@latest application create`, then restart the wizard."
-    );
-  }
-  if (apps.length === 1) {
-    const only = apps[0];
-    logger.info(
-      { app: only.id },
-      "single application on the account; selecting it"
-    );
-    for (const line of leadIn) store.pushCliOutput("stdout", line);
-    return selectAndReport(only);
-  }
-  const messages = [
-    ...leadIn,
-    "Which Algolia application should the wizard work in?"
-  ];
-  for (; ; ) {
-    const choice = await store.requestUserInput({
-      prompt: "Select an application",
-      promptType: "multipleChoice",
-      options: apps.map(labelFor),
-      secondary: apps.map(secondaryFor),
-      messages
-    });
-    const chosen = apps.find((app) => labelFor(app) === choice);
-    if (!chosen) {
-      throw new Error("Application picker received an unexpected selection");
-    }
-    try {
-      return await selectAndReport(chosen);
-    } catch (err) {
-      logger.warn(
-        { app: chosen.id, err: err.message },
-        "application select failed; re-prompting"
-      );
-      messages.push(
-        `Could not select \u201C${labelFor(chosen)}\u201D. It may have been removed \u2014 pick another.`
-      );
-    }
-  }
-}
-async function confirmEnvApplication(env, current) {
-  const useEnv = `Use ${env.id} (from ${env.file})`;
-  const choice = await useWizard.getState().requestUserInput({
-    prompt: "Select an application",
-    promptType: "multipleChoice",
-    options: [
-      useEnv,
-      current ? `Use ${labelFor(current)} (already selected)` : "Pick a different application"
-    ],
-    messages: [
-      `${env.file} already sets ${env.name}=${env.id}.`,
-      "Which Algolia application should the wizard work in?"
-    ]
-  });
-  return choice === useEnv;
-}
-async function selectEnvApplication(env) {
-  try {
-    return await selectAndReport({ id: env.id, name: "" });
-  } catch (err) {
-    logger.warn(
-      { app: env.id, err: err.message },
-      "could not select the application named in env; falling back to the picker"
-    );
-    return promptForApplication([
-      `Could not select ${env.id} from ${env.file} \u2014 it may have been removed, or this account may not have access to it.`
-    ]);
-  }
-}
-async function ensureApplication() {
-  const current = await currentApplication();
-  const env = await findEnvApplicationId();
-  if (env && env.id !== current?.id && await confirmEnvApplication(env, current)) {
-    return selectEnvApplication(env);
-  }
-  return current ?? await promptForApplication();
-}
-
-// src/workflows/default.ts
-import { z as z29 } from "zod";
-
-// src/actions/listIndices.ts
-import { z as z5 } from "zod";
-var indicesListSchema = z5.object({
-  items: z5.array(
-    z5.object({
-      name: z5.string(),
-      entries: z5.number().default(0)
-    })
-  )
-});
-async function listIndices() {
-  const stdout = await runAlgoliaCli(["indices", "list", "-o", "json"]);
-  const { items } = indicesListSchema.parse(JSON.parse(stdout));
-  return items.map((i) => ({ name: i.name, entries: i.entries })).sort((a, b) => a.name.localeCompare(b.name));
+async function listIndices() {
+  const stdout = await runAlgoliaCli(["indices", "list", "-o", "json"]);
+  const { items } = indicesListSchema.parse(JSON.parse(stdout));
+  return items.map((i) => ({ name: i.name, entries: i.entries })).sort((a, b) => a.name.localeCompare(b.name));
 }
 
 // src/actions/selectIndex.ts
@@ -2715,8 +1652,8 @@ var selectIndexStep = async (ctx) => {
 };
 
 // src/lib/agent.ts
-import { ToolLoopAgent, hasToolCall, Output as Output2 } from "ai";
-import { createAnthropic as createAnthropic2 } from "@ai-sdk/anthropic";
+import { ToolLoopAgent, hasToolCall, Output as Output3 } from "ai";
+import { createAnthropic as createAnthropic3 } from "@ai-sdk/anthropic";
 import "zod";
 
 // src/lib/tools/index.ts
@@ -2724,12 +1661,12 @@ import "zod";
 
 // src/lib/tools/listFiles.ts
 import { tool } from "ai";
-import z6 from "zod";
+import z5 from "zod";
 import { readdir } from "node:fs/promises";
 
 // src/lib/tools/path.ts
 import { lstat } from "node:fs/promises";
-import { resolve as resolve2, relative, isAbsolute, dirname as dirname3, join as join7, sep } from "node:path";
+import { resolve as resolve2, relative, isAbsolute, dirname as dirname2, join as join5, sep } from "node:path";
 function resolveInRoot(ctx, path) {
   const target = resolve2(ctx.cwd, path);
   const rel = relative(ctx.root, target);
@@ -2743,9 +1680,9 @@ function resolveInRoot(ctx, path) {
 }
 async function hasSymlinkParent(ctx, target) {
   let current = ctx.root;
-  const parts = relative(ctx.root, dirname3(target)).split(sep).filter(Boolean);
+  const parts = relative(ctx.root, dirname2(target)).split(sep).filter(Boolean);
   for (const part of parts) {
-    current = join7(current, part);
+    current = join5(current, part);
     try {
       if ((await lstat(current)).isSymbolicLink()) return true;
     } catch (err) {
@@ -2760,8 +1697,8 @@ async function hasSymlinkParent(ctx, target) {
 function listFilesTool(ctx) {
   return tool({
     description: 'List files in a directory (default: the current working directory). Pass path to list a subdirectory directly \u2014 e.g. "packages/api" \u2014 without first changeDirectory-ing into it.',
-    inputSchema: z6.object({
-      path: z6.string().optional().describe("Directory to list, relative to cwd (default: cwd)")
+    inputSchema: z5.object({
+      path: z5.string().optional().describe("Directory to list, relative to cwd (default: cwd)")
     }),
     execute: async ({ path = "." }) => {
       logger.info({ path }, "called listFiles tool");
@@ -2782,13 +1719,13 @@ function listFilesTool(ctx) {
 
 // src/lib/tools/changeDirectory.ts
 import { tool as tool2 } from "ai";
-import z7 from "zod";
+import z6 from "zod";
 import { stat } from "node:fs/promises";
 function changeDirectoryTool(ctx) {
   return tool2({
     description: "Change the current working directory. Subsequent file operations resolve relative to it. Returns the new working directory.",
-    inputSchema: z7.object({
-      path: z7.string().describe("Directory to change into")
+    inputSchema: z6.object({
+      path: z6.string().describe("Directory to change into")
     }),
     execute: async ({ path }) => {
       logger.info({ path }, "called changeDirectory tool");
@@ -2810,13 +1747,13 @@ function changeDirectoryTool(ctx) {
 
 // src/lib/tools/reportStatus.ts
 import { tool as tool3 } from "ai";
-import z8 from "zod";
+import z7 from "zod";
 function reportStatusTool(output) {
   return tool3({
     description: "Report the status of your execution. Return a reason in case of failure.",
-    inputSchema: z8.object({
-      status: z8.enum(["success", "fail"]),
-      reason: z8.string().optional(),
+    inputSchema: z7.object({
+      status: z7.enum(["success", "fail"]),
+      reason: z7.string().optional(),
       output
     }),
     execute: async ({ status, reason, output: output2 }) => {
@@ -2828,8 +1765,8 @@ function reportStatusTool(output) {
 
 // src/lib/tools/readFile.ts
 import { tool as tool4 } from "ai";
-import z9 from "zod";
-import { readFile as readFile4 } from "node:fs/promises";
+import z8 from "zod";
+import { readFile as readFile3 } from "node:fs/promises";
 
 // src/lib/tools/env.ts
 import { basename } from "node:path";
@@ -2856,8 +1793,8 @@ function redactEnvValues(content) {
 function readFileTool(ctx) {
   return tool4({
     description: "Read the contents of a file at the given path",
-    inputSchema: z9.object({
-      filePath: z9.string().describe("Path to the file to read")
+    inputSchema: z8.object({
+      filePath: z8.string().describe("Path to the file to read")
     }),
     execute: async ({ filePath }) => {
       if (++ctx.counts.read > ctx.limits.read) {
@@ -2867,7 +1804,7 @@ function readFileTool(ctx) {
       const resolved2 = resolveInRoot(ctx, filePath);
       if (!resolved2.ok) return resolved2.error;
       try {
-        const content = await readFile4(resolved2.target, "utf8");
+        const content = await readFile3(resolved2.target, "utf8");
         return isEnvFile(resolved2.target) ? redactEnvValues(content) : content;
       } catch (err) {
         return `Error reading ${filePath}: ${err.message}`;
@@ -2878,15 +1815,15 @@ function readFileTool(ctx) {
 
 // src/lib/tools/writeFile.ts
 import { tool as tool5 } from "ai";
-import z10 from "zod";
+import z9 from "zod";
 import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname4 } from "node:path";
+import { dirname as dirname3 } from "node:path";
 function writeFileTool(ctx) {
   return tool5({
     description: "Write content to a file at the given path, overwriting it. To set Algolia credentials in an env file, use writeCredentials instead of this tool.",
-    inputSchema: z10.object({
-      filePath: z10.string().describe("Path to the file to write"),
-      content: z10.string().describe("Content to write to the file")
+    inputSchema: z9.object({
+      filePath: z9.string().describe("Path to the file to write"),
+      content: z9.string().describe("Content to write to the file")
     }),
     execute: async ({ filePath, content }) => {
       logger.info({ filePath }, "called writeFile tool");
@@ -2899,7 +1836,7 @@ function writeFileTool(ctx) {
         if (await hasSymlinkParent(ctx, resolved2.target)) {
           return `Refused: ${resolved2.target} is outside the repo root (${ctx.root}).`;
         }
-        await mkdir3(dirname4(resolved2.target), { recursive: true });
+        await mkdir3(dirname3(resolved2.target), { recursive: true });
         await writeFile3(resolved2.target, content, "utf8");
         useWizard.getState().recordWrittenFile(resolved2.target);
         return `Wrote to ${filePath}`;
@@ -2913,8 +1850,70 @@ function writeFileTool(ctx) {
 // src/lib/tools/writeAlgoliaCredentials.ts
 import { tool as tool6 } from "ai";
 import z13 from "zod";
-import { mkdir as mkdir4, readFile as readFile6, writeFile as writeFile5 } from "node:fs/promises";
-import { dirname as dirname5, relative as relative3 } from "node:path";
+import { mkdir as mkdir4, readFile as readFile5, writeFile as writeFile5 } from "node:fs/promises";
+import { dirname as dirname4, relative as relative3 } from "node:path";
+
+// src/lib/algoliaApp.ts
+import { z as z10 } from "zod";
+var applicationSchema = z10.object({
+  id: z10.string().min(1),
+  name: z10.string().default(""),
+  plan: z10.string().optional()
+});
+var listSchema = z10.array(
+  z10.object({
+    id: z10.string().min(1),
+    name: z10.string().default(""),
+    plan_label: z10.string().optional()
+  }).transform(({ id, name, plan_label }) => ({ id, name, plan: plan_label }))
+);
+async function currentApplication() {
+  let raw;
+  try {
+    raw = await runAlgoliaCli(["application", "current", "-o", "json"]);
+  } catch {
+    return null;
+  }
+  const parsed = applicationSchema.safeParse(parseJson(raw));
+  return parsed.success ? parsed.data : null;
+}
+async function requireApplication() {
+  const app = await currentApplication();
+  if (!app) {
+    throw new Error(
+      "No Algolia application is selected. Run `npx @algolia/cli@latest application select` and restart the wizard."
+    );
+  }
+  return app;
+}
+async function listApplications() {
+  const raw = await runAlgoliaCli(["application", "list", "-o", "json"]);
+  const parsed = listSchema.safeParse(parseJson(raw));
+  if (!parsed.success) {
+    throw new Error("Could not read the list of Algolia applications.");
+  }
+  return parsed.data;
+}
+async function selectApplication(id) {
+  const raw = await runAlgoliaCli(
+    ["application", "select", "--non-interactive", "--app-id", id],
+    { onOutput: stderrSink }
+  );
+  const parsed = applicationSchema.safeParse(parseJson(raw));
+  if (!parsed.success) {
+    throw new Error(
+      `Selected application ${id}, but the Algolia CLI returned an unreadable result.`
+    );
+  }
+  return parsed.data;
+}
+function parseJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
 
 // src/lib/algoliaApiKey.ts
 import { z as z12 } from "zod";
@@ -3097,8 +2096,8 @@ async function resolveSearchOnlyKey(index, appId) {
 
 // src/lib/gitignore.ts
 import { execFile } from "node:child_process";
-import { lstat as lstat2, readFile as readFile5, writeFile as writeFile4 } from "node:fs/promises";
-import { join as join8, relative as relative2 } from "node:path";
+import { lstat as lstat2, readFile as readFile4, writeFile as writeFile4 } from "node:fs/promises";
+import { join as join6, relative as relative2 } from "node:path";
 var GIT_ENV_OVERRIDES = [
   "GIT_DIR",
   "GIT_WORK_TREE",
@@ -3150,7 +2149,7 @@ async function ensureGitIgnored(root, target) {
   if (ignoredByRule === void 0) return "unknown";
   if (ignoredByRule) return tracked ? "tracked" : "covered";
   const pattern = relative2(root, target);
-  const gitIgnore = join8(root, ".gitignore");
+  const gitIgnore = join6(root, ".gitignore");
   try {
     const link = await lstat2(gitIgnore).catch(() => null);
     if (link?.isSymbolicLink()) {
@@ -3160,7 +2159,7 @@ async function ensureGitIgnored(root, target) {
       );
       return "unknown";
     }
-    const existing = link ? await readFile5(gitIgnore, "utf8") : "";
+    const existing = link ? await readFile4(gitIgnore, "utf8") : "";
     const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
     await writeFile4(gitIgnore, `${existing}${prefix}${pattern}
 `, "utf8");
@@ -3229,7 +2228,7 @@ function writeCredentialsTool(ctx) {
           return `Refused: ${resolved2.target} is outside the repo root (${ctx.root}).`;
         }
         try {
-          existing = await readFile6(resolved2.target, "utf8");
+          existing = await readFile5(resolved2.target, "utf8");
         } catch (err) {
           if (err.code !== "ENOENT") throw err;
         }
@@ -3279,7 +2278,7 @@ function writeCredentialsTool(ctx) {
           (content, [name, value]) => upsertEnv(content, name, value),
           existing
         );
-        await mkdir4(dirname5(resolved2.target), { recursive: true });
+        await mkdir4(dirname4(resolved2.target), { recursive: true });
         await writeFile5(resolved2.target, updated, "utf8");
         const sentences = [
           `Wrote ${[...credentials.map(([name]) => name), INDEX_NAME_VAR].join(", ")} to ${filePath}.`
@@ -3319,8 +2318,8 @@ async function gitIgnoreOutcome(ctx, target) {
 // src/lib/tools/searchFiles.ts
 import { tool as tool7 } from "ai";
 import z14 from "zod";
-import { readdir as readdir2, readFile as readFile7 } from "node:fs/promises";
-import { join as join9 } from "node:path";
+import { readdir as readdir2, readFile as readFile6 } from "node:fs/promises";
+import { join as join7 } from "node:path";
 var MAX_QUERY_LENGTH = 1e3;
 var SKIP_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
@@ -3335,7 +2334,7 @@ async function walkFiles(dir) {
   const out = [];
   for (const e of await readdir2(dir, { withFileTypes: true })) {
     if (e.name.startsWith(".") || SKIP_DIRS.has(e.name)) continue;
-    const full = join9(dir, e.name);
+    const full = join7(dir, e.name);
     if (e.isDirectory()) out.push(...await walkFiles(full));
     else if (e.isFile()) out.push(full);
   }
@@ -3368,7 +2367,7 @@ function searchFilesTool(ctx) {
       for (const file of await walkFiles(resolved2.target)) {
         let content;
         try {
-          content = await readFile7(file, "utf8");
+          content = await readFile6(file, "utf8");
         } catch {
           continue;
         }
@@ -3389,7 +2388,8 @@ function searchFilesTool(ctx) {
 }
 
 // src/lib/tools/runShell.ts
-import { tool as tool8 } from "ai";
+import { tool as tool8, generateText, Output } from "ai";
+import { createAnthropic } from "@ai-sdk/anthropic";
 import z15 from "zod";
 import { relative as relative4 } from "node:path";
 
@@ -3498,8 +2498,10 @@ function runShell(command, opts) {
 // src/lib/tools/runShell.ts
 function storeApproval(root) {
   return async (req) => {
+    const store = useWizard.getState();
+    if (store.isCommandApproved(req.command, req.cwd)) return "approve";
     const rel = relative4(root, req.cwd);
-    const answer = await useWizard.getState().requestUserInput({
+    const answer = await store.requestUserInput({
       prompt: "Run this command?",
       promptType: "commandApproval",
       options: [],
@@ -3508,20 +2510,195 @@ function storeApproval(root) {
         cwd: rel === "" || rel.startsWith("..") ? req.cwd : rel
       }
     });
-    return answer === "approve" ? "approve" : "reject";
+    if (answer !== "approve") return "reject";
+    store.approveCommand(req.command, req.cwd);
+    return "approve";
   };
 }
 var EXPLORATORY_COMMANDS = /* @__PURE__ */ new Set(["ls", "find", "tree", "dir"]);
+function commandSegments(command) {
+  return command.split(/&&|;|\|/).map((segment) => segment.trim());
+}
 function isExploratoryCommand(command) {
-  return command.split(/&&|;|\|/).map((segment) => segment.trim().split(/\s+/)[0]).some((word) => word !== void 0 && EXPLORATORY_COMMANDS.has(word));
+  return commandSegments(command).map((segment) => segment.split(/\s+/)[0]).some((word) => word !== void 0 && EXPLORATORY_COMMANDS.has(word));
+}
+var READ_ONLY_BINARIES = /* @__PURE__ */ new Set([
+  "cat",
+  "head",
+  "tail",
+  "wc",
+  "pwd",
+  "echo",
+  "date",
+  "whoami",
+  "hostname",
+  "uname",
+  "which",
+  "file",
+  "stat",
+  "grep",
+  "egrep",
+  "fgrep",
+  "rg",
+  "diff"
+]);
+var READ_ONLY_NO_ARGS_BINARIES = /* @__PURE__ */ new Set(["env", "printenv"]);
+var GIT_READ_ONLY_SUBCOMMANDS = /* @__PURE__ */ new Set([
+  "status",
+  "log",
+  "diff",
+  "show",
+  "describe",
+  "blame",
+  "ls-files",
+  "rev-parse",
+  "cat-file",
+  "shortlog",
+  "ls-remote"
+]);
+var VERSION_CHECK_BINARIES = /* @__PURE__ */ new Set([
+  "node",
+  "tsc",
+  "npm",
+  "pnpm",
+  "yarn",
+  "python",
+  "python3",
+  "ruby",
+  "go",
+  "cargo",
+  "rustc",
+  "php",
+  "composer",
+  "java",
+  "mvn",
+  "gradle",
+  "bundle",
+  "git"
+]);
+var VERSION_FLAGS = /* @__PURE__ */ new Set(["--version", "-v", "-V"]);
+var FD_DUP_REDIRECT = /\d*>&\d+/g;
+function stripQuoted(segment) {
+  let result = "";
+  let quote = null;
+  let i = 0;
+  while (i < segment.length) {
+    const char = segment[i];
+    if (quote === "'") {
+      if (char === "'") quote = null;
+      i++;
+    } else if (char === "\\") {
+      i += 2;
+    } else if (quote) {
+      if (char === quote) quote = null;
+      i++;
+    } else if (char === '"' || char === "'") {
+      quote = char;
+      i++;
+    } else {
+      result += char;
+      i++;
+    }
+  }
+  return quote === null ? result : segment;
 }
-async function approveAndRun(ctx, command, cwd, explanation) {
-  const decision = await ctx.shell.approve({ command, cwd, explanation });
-  if (decision === "reject") {
-    ctx.shell.executions.push({ command, cwd, approved: false });
-    logger.info({ command }, "runShell: user rejected the command");
-    return "The user rejected this command. Do not retry it. Propose a different command, or report the limitation via reportStatus.";
+function hasFileRedirect(segment) {
+  return stripQuoted(segment.replace(FD_DUP_REDIRECT, "")).includes(">");
+}
+function hasShellInjectionRisk(segment) {
+  if (segment.includes("$(") || segment.includes("<(") || segment.includes("`")) {
+    return true;
+  }
+  return stripQuoted(segment.replace(FD_DUP_REDIRECT, "")).includes("&");
+}
+function fastPathSegmentSafety(segment) {
+  if (!segment) return true;
+  if (hasFileRedirect(segment)) return false;
+  if (hasShellInjectionRisk(segment)) return false;
+  const [cmd0, ...rest] = segment.split(/\s+/);
+  if (cmd0 === void 0) return true;
+  if (VERSION_CHECK_BINARIES.has(cmd0) && rest.length === 1 && VERSION_FLAGS.has(rest[0])) {
+    return true;
+  }
+  if (READ_ONLY_BINARIES.has(cmd0)) return true;
+  if (READ_ONLY_NO_ARGS_BINARIES.has(cmd0)) {
+    return rest.length === 0 ? true : void 0;
+  }
+  if (cmd0 === "git") {
+    return GIT_READ_ONLY_SUBCOMMANDS.has(rest[0] ?? "") ? true : void 0;
+  }
+  return void 0;
+}
+function fastPathSafety(command) {
+  const results = commandSegments(command).map(fastPathSegmentSafety);
+  if (results.some((r) => r === false)) return false;
+  if (results.every((r) => r === true)) return true;
+  return void 0;
+}
+var CLASSIFIER_MODEL = "claude-haiku-4-5";
+var commandSafetySchema = z15.object({
+  safe: z15.boolean(),
+  reason: z15.string().describe("One short sentence explaining the verdict.")
+});
+function defaultCreateModel() {
+  const token = getAuthToken();
+  if (!token) {
+    throw new Error("Not authenticated: no user token available");
+  }
+  return createAnthropic({
+    apiKey: token,
+    baseURL: PROXY_BASE_URL,
+    fetch: proxyFetch
+  });
+}
+function approvedCommandHistory(approvedCommands) {
+  return Array.from(approvedCommands).map((entry) => {
+    const sep2 = entry.indexOf("\0");
+    return { cwd: entry.slice(0, sep2), command: entry.slice(sep2 + 1) };
+  });
+}
+async function classifyCommandSafety(createModel, command, cwd, explanation, approvedHistory) {
+  try {
+    const anthropic = createModel();
+    const { output } = await generateText({
+      model: anthropic(CLASSIFIER_MODEL),
+      temperature: 0,
+      output: Output.object({ schema: commandSafetySchema }),
+      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.",
+        "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.',
+        "(3) Running the project's own tests, type checker, linter, or build/compile step (e.g. `npm run build`, `yarn build`, `vite build`, `webpack`, `tsc`, `cargo build`, `go build`, `mvn compile`), as long as it is not passed an autofix/write/update flag (e.g. --fix, -u, --write, rubocop -a) \u2014 this holds even though the point of a build step is to write compiled output to a build/dist/target directory inside the project (e.g. a target/, build/, dist/, or __pycache__ directory): writing that output does not make the command unsafe. It stops being safe the moment the command chain goes past building \u2014 a step that also deploys, publishes, uploads, or pushes the build (e.g. `next build && vercel deploy`, `npm run build && npm publish`) is unsafe for that later segment even though the build segment itself is fine; judge each chained segment on its own, same as elsewhere in this list.",
+        "Deleting or removing anything is unsafe, even something in a cache or build directory (e.g. `rm -rf __pycache__`, `cargo clean`, `git clean`), and even if the command otherwise fits one of the three categories above. Installing, uninstalling, or upgrading a dependency, changing a database schema, or writing to a path outside the project is also unsafe. A command chained with && or ; is only safe if every part of the chain is safe on its own.",
+        "One specific, narrow exception to all of the above: when the command literally invokes one of these runner programs BY NAME as the leading command \u2014 npx, bunx, pnpm dlx, yarn dlx, pipx run, uvx \u2014 it is unsafe regardless of what it then runs, even something that looks like a harmless test/lint/typecheck command (e.g. `npx tsc --noEmit`, `uvx ruff check .`), because that runner can fetch and execute a different, unreviewed version of a package from a registry each time. This exception is about that specific syntax, not a general doubt about whether a tool is installed: a plain `ruff check .`, `pytest`, or any other bare command name is NOT this exception merely because you cannot verify from the string alone that it is installed \u2014 judge those the same as any other already-installed project tool, per the categories above. If you are unsure, judge it unsafe.",
+        ...approvedHistory.length > 0 ? [
+          "The user has already explicitly approved these exact commands earlier in this session (working directory in parentheses, then the command):",
+          approvedHistory.map((h) => `- (${h.cwd}) ${h.command}`).join("\n"),
+          "If the new command performs the same action and side-effect profile as one of these \u2014 differing only in a trivial way, such as a different file path, package name, or argument value that does not change what kind of action it is \u2014 judge it SAFE on that precedent, even if it would not otherwise fit categories (1)-(3) above. Do not stretch this to a command that merely shares a binary name, or superficially resembles one on the list while doing something riskier or of a different kind (e.g. an approved `rm build/tmp.log` does not license a new `rm -rf src/`, and an approved `git push origin feature-x` does not license `git push --force`)."
+        ] : [],
+        `Command: ${command}`,
+        `Working directory: ${cwd}`,
+        `Stated purpose: ${explanation}`
+      ].join("\n")
+    });
+    if (!output.safe) {
+      logger.info(
+        { command, reason: output.reason },
+        "runShell: classifier judged command unsafe, requiring approval"
+      );
+    }
+    return output.safe;
+  } catch (err) {
+    logger.warn(
+      { err, command },
+      "runShell: command safety classifier failed, requiring approval"
+    );
+    return false;
   }
+}
+async function runAndRecord(ctx, command, cwd) {
   useWizard.getState().pushNotice({ messages: [`Running: ${command}`] });
   const env = await ctx.shell.env().catch((err) => {
     logger.warn({ err, command }, "runShell: could not resolve command env");
@@ -3557,9 +2734,18 @@ async function approveAndRun(ctx, command, cwd, explanation) {
     output: run2.output
   };
 }
-function runShellTool(ctx) {
+async function approveAndRun(ctx, command, cwd, explanation) {
+  const decision = await ctx.shell.approve({ command, cwd, explanation });
+  if (decision === "reject") {
+    ctx.shell.executions.push({ command, cwd, approved: false });
+    logger.info({ command }, "runShell: user rejected the command");
+    return "The user rejected this command. Do not retry it. Propose a different command, or report the limitation via reportStatus.";
+  }
+  return runAndRecord(ctx, command, cwd);
+}
+function runShellTool(ctx, createModel = defaultCreateModel) {
   return tool8({
-    description: "Run a shell command in the project. Use this for anything the project needs done in its own ecosystem: installing dependencies, running a script you wrote, running the project's lint/typecheck/test commands. To inspect the project, use listFiles or searchFiles instead of ls/find \u2014 this tool refuses those. The user sees and approves every command before it runs, so write a clear `explanation`. If the user rejects a command, do not retry it \u2014 propose a different approach.",
+    description: "Run a shell command in the project. Use this for anything the project needs done in its own ecosystem: installing dependencies, running a script you wrote, running the project's lint/typecheck/test commands. Do not use this to find or read files \u2014 use listFiles, searchFiles, and readFile instead of ls/find/cat/head/tail/grep/rg. This tool refuses ls/find/tree/dir outright; a read command like cat is not refused (some read-only commands run without approval, see below), but it's still the wrong tool for reading a file \u2014 the dedicated tools exist for that and won't count against this tool's command budget. The user approves any command that could change the project before it runs, so write a clear `explanation`. A command judged read-only (inspection, or running tests/typecheck/lint without an autofix flag, in any language) runs immediately without approval. If the user rejects a command, do not retry it \u2014 propose a different approach.",
     inputSchema: z15.object({
       command: z15.string().describe(
         "The command to run, exactly as it would be typed in a shell. Pipes, && and redirects are allowed."
@@ -3578,9 +2764,29 @@ function runShellTool(ctx) {
       const resolved2 = resolveInRoot(ctx, cwd ?? ".");
       if (!resolved2.ok) return resolved2.error;
       if (isExploratoryCommand(command)) {
-        return "Refused: use listFiles or searchFiles to inspect the project instead of ls/find/tree.";
+        return "Refused: use listFiles or searchFiles to find files, and readFile to read one, instead of ls/find/tree/dir.";
       }
       logger.info({ command, cwd: resolved2.target }, "called runShell tool");
+      const fast = fastPathSafety(command);
+      let isSafe = fast;
+      if (isSafe === void 0) {
+        const store = useWizard.getState();
+        isSafe = store.isCommandApproved(command, resolved2.target);
+        if (!isSafe) {
+          isSafe = await classifyCommandSafety(
+            createModel,
+            command,
+            resolved2.target,
+            explanation,
+            approvedCommandHistory(store.approvedCommands)
+          );
+        }
+      }
+      if (isSafe) {
+        return serializePrompt(
+          () => runAndRecord(ctx, command, resolved2.target)
+        );
+      }
       return serializePrompt(
         () => approveAndRun(ctx, command, resolved2.target, explanation)
       );
@@ -3630,29 +2836,29 @@ function reviewScriptTool(ctx) {
 }
 
 // src/lib/tools/generateRecord.ts
-import { tool as tool10, generateText, Output, NoObjectGeneratedError } from "ai";
-import { createAnthropic } from "@ai-sdk/anthropic";
+import { tool as tool10, generateText as generateText2, Output as Output2, NoObjectGeneratedError } from "ai";
+import { createAnthropic as createAnthropic2 } from "@ai-sdk/anthropic";
 import { nanoid as nanoid2 } from "nanoid";
 import { mkdir as mkdir5, writeFile as writeFile6 } from "node:fs/promises";
-import { dirname as dirname6 } from "node:path";
+import { dirname as dirname5 } from "node:path";
 import z17 from "zod";
 var DATA_DIR = ".algolia-wizard/data";
 var RECORD_MODEL = "claude-haiku-4-5";
 var MAX_RECORDS = 100;
 var BATCH_SIZE = 10;
 var MAX_BATCH_ATTEMPTS = 3;
-function defaultCreateModel() {
+function defaultCreateModel2() {
   const token = getAuthToken();
   if (!token) {
     throw new Error("Not authenticated: no user token available");
   }
-  return createAnthropic({
+  return createAnthropic2({
     apiKey: token,
     baseURL: PROXY_BASE_URL,
     fetch: proxyFetch
   });
 }
-function generateRecordTool(ctx, createModel = defaultCreateModel) {
+function generateRecordTool(ctx, createModel = defaultCreateModel2) {
   return tool10({
     description: "Generate realistic sample records for an entity and write them to a JSON file. Provide the entity name and its attributes; this tool asks a model to invent varied, realistic values, each with a unique objectID, and returns the file path to read them from at runtime. Do not invent the record values or objectIDs yourself, and do not inline the returned records into the script \u2014 call this tool and read the file it writes.",
     inputSchema: z17.object({
@@ -3673,9 +2879,9 @@ function generateRecordTool(ctx, createModel = defaultCreateModel) {
           let lastError;
           for (let attempt = 1; attempt <= MAX_BATCH_ATTEMPTS; attempt++) {
             try {
-              const { output } = await generateText({
+              const { output } = await generateText2({
                 model: anthropic(RECORD_MODEL),
-                output: Output.object({
+                output: Output2.object({
                   schema: z17.object({
                     records: z17.array(recordSchema).length(batchCount)
                   })
@@ -3714,7 +2920,7 @@ function generateRecordTool(ctx, createModel = defaultCreateModel) {
         if (await hasSymlinkParent(ctx, resolved2.target)) {
           return `Refused: ${resolved2.target} is outside the repo root (${ctx.root}).`;
         }
-        await mkdir5(dirname6(resolved2.target), { recursive: true });
+        await mkdir5(dirname5(resolved2.target), { recursive: true });
         await writeFile6(
           resolved2.target,
           JSON.stringify(records, null, 2),
@@ -3840,7 +3046,7 @@ async function runAgentAttempt(req, attempt) {
   if (!token) {
     throw new Error("Not authenticated: no user token available");
   }
-  const anthropic = createAnthropic2({
+  const anthropic = createAnthropic3({
     apiKey: token,
     baseURL: PROXY_BASE_URL,
     fetch: proxyFetch
@@ -3877,7 +3083,7 @@ async function runAgentAttempt(req, attempt) {
         }
       };
     }),
-    output: Output2.object({ schema: req.outputSchema }),
+    output: Output3.object({ schema: req.outputSchema }),
     tools: createTools(toolContext, {
       output: req.outputSchema,
       tools: req.tools
@@ -4061,7 +3267,7 @@ async function runAnalysis(mode, extraInstructions = []) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.34.0-rc.125.245",
+  version: "0.35.0-rc.125.251",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -4467,12 +3673,13 @@ ${formatCompletedSteps(ctx.completedSteps)}`,
 
 // src/actions/implement.ts
 import z28 from "zod";
-import { relative as relative6, join as join12 } from "node:path";
+import { mkdir as mkdir7 } from "node:fs/promises";
+import { join as join10, relative as relative6 } from "node:path";
 
 // src/lib/git.ts
 import { execFile as execFile2 } from "node:child_process";
 import { copyFile, mkdir as mkdir6, stat as stat3 } from "node:fs/promises";
-import { basename as basename2, dirname as dirname7, isAbsolute as isAbsolute2, join as join10, resolve as resolve3 } from "node:path";
+import { basename as basename2, dirname as dirname6, isAbsolute as isAbsolute2, join as join8, resolve as resolve3 } from "node:path";
 var MAX_BUFFER = 32 * 1024 * 1024;
 function git(args) {
   return new Promise((resolve4, reject) => {
@@ -4509,13 +3716,13 @@ async function copyUploadIntoProject(repoRoot, ingestDir, sourcePath) {
   } catch {
     return { ok: false, reason: `"${sourcePath}" does not exist` };
   }
-  const relPath = join10(ingestDir, basename2(source));
-  const dest = join10(repoRoot, relPath);
+  const relPath = join8(ingestDir, basename2(source));
+  const dest = join8(repoRoot, relPath);
   if (resolve3(source) === resolve3(dest)) {
     return { ok: true, relPath };
   }
   try {
-    await mkdir6(dirname7(dest), { recursive: true });
+    await mkdir6(dirname6(dest), { recursive: true });
     await copyFile(source, dest);
   } catch (err) {
     return {
@@ -4549,15 +3756,15 @@ function toRootRelative(p) {
 
 // src/lib/algoliaDocs.ts
 import { readFileSync, readdirSync, existsSync } from "node:fs";
-import { dirname as dirname8, join as join11 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
-var DOCS_SUBPATH = join11("docs", "algolia-sdk");
+import { dirname as dirname7, join as join9 } from "node:path";
+import { fileURLToPath } from "node:url";
+var DOCS_SUBPATH = join9("docs", "algolia-sdk");
 function findDocsDir() {
-  let dir = dirname8(fileURLToPath2(import.meta.url));
+  let dir = dirname7(fileURLToPath(import.meta.url));
   for (; ; ) {
-    const candidate = join11(dir, DOCS_SUBPATH);
+    const candidate = join9(dir, DOCS_SUBPATH);
     if (existsSync(candidate)) return candidate;
-    const parent = dirname8(dir);
+    const parent = dirname7(dir);
     if (parent === dir) return void 0;
     dir = parent;
   }
@@ -4578,7 +3785,7 @@ function loadAlgoliaDoc(language) {
     );
     return "";
   }
-  return readFileSync(join11(docsDir, files[0]), "utf8").trim();
+  return readFileSync(join9(docsDir, files[0]), "utf8").trim();
 }
 function getNamedDoc(name, language) {
   const docsDir = findDocsDir();
@@ -4586,7 +3793,7 @@ function getNamedDoc(name, language) {
     logger.warn("docs/algolia-sdk not found");
     return "";
   }
-  const file = join11(docsDir, `${name}-${language}.md`);
+  const file = join9(docsDir, `${name}-${language}.md`);
   if (!existsSync(file)) {
     logger.warn({ name, language }, "named SDK reference not found");
     return "";
@@ -4714,7 +3921,7 @@ function algoliaClientDoc(input) {
 function ingestionInstructions(input) {
   return [
     ...input.confirmed && input.confirmed.length ? [
-      `Create an ingestion script under "${input.ingestDir}/" at the repo root.`,
+      `Create an ingestion script under "${input.ingestDir}/" at the repo root. That directory already exists \u2014 writeFile creates any nested path itself, so never run a shell command just to create a directory.`,
       `Ingest only the confirmed entity (name, source paths, attributes): ${JSON.stringify(input.confirmed)}.`,
       `Ingesting writes to Algolia, so the script needs a write API key and App ID \u2014 read them from the ${API_KEY_VAR} and ${APP_ID_VAR} environment variables rather than hardcoding them. The wizard sets these when it runs the script.`,
       `Read the index name from the ${INDEX_NAME_VAR} environment variable, which the wizard sets to "${input.targetIndex}". Never hardcode an index name or derive one from the project, file, or entity name \u2014 the write key only works for that exact index. Exit with an error if ${INDEX_NAME_VAR} is unset.`,
@@ -4932,6 +4139,9 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
   const targetIndex = selected?.selection;
   useWizard.getState().setTargetIndex(targetIndex ?? null);
   await assertGitRepoWithHead(repoRoot);
+  if (useCases.includes("ingestion")) {
+    await mkdir7(join10(repoRoot, INGEST_DIR), { recursive: true });
+  }
   const normalized = normalizeFindingPaths(findings);
   const confirmed2 = normalized.confirmedEntities;
   const searchLocation = normalized.searchImplementationAnalysis;
@@ -5156,7 +4366,7 @@ ${detail}` : ""}`
     if (searchConfigFile) {
       const ignoreStatus = await gitIgnoreStatus(
         repoRoot,
-        join12(repoRoot, searchConfigFile)
+        join10(repoRoot, searchConfigFile)
       );
       if (ignoreStatus === "covered") {
         summaries.push(
@@ -5202,6 +4412,7 @@ var defaultWorkflow = {
       id: "project-scan",
       title: "project scan",
       outputSchema: projectScanSchema,
+      tips: ["apps-and-indices", "records-are-json", "speed"],
       run: (ctx) => {
         ctx.notify({
           messages: [
@@ -5237,6 +4448,7 @@ var defaultWorkflow = {
       id: "ingestion",
       title: "ingest records",
       outputSchema: implementSchema,
+      tips: ["records-are-json", "searchable-attributes", "facets"],
       run: (ctx) => {
         ctx.notify({
           messages: [
@@ -5257,6 +4469,13 @@ var defaultWorkflow = {
       id: "search",
       title: "create search ui",
       outputSchema: implementSchema,
+      tips: [
+        "test-relevance",
+        "search-analytics",
+        "recommend",
+        "searchable-attributes",
+        "facets"
+      ],
       run: (ctx) => {
         ctx.notify({
           messages: ["Building your Algolia search experience\u2026"]
@@ -5293,6 +4512,1045 @@ function getWorkflow(id) {
   return workflows[id];
 }
 
+// src/ui/Welcome.tsx
+import { dirname as dirname8, join as join11 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { useState as useState7 } from "react";
+import { Box as Box10, Spacer, Text as Text10, useInput as useInput3, useWindowSize as useWindowSize5 } from "ink";
+
+// src/ui/copy/welcome.ts
+var sidebarItems = [
+  {
+    title: "scan your project",
+    description: "detect models, schemas, and data worth indexing"
+  },
+  {
+    title: "select and index",
+    description: "push 100 records to Algolia in seconds"
+  },
+  {
+    title: "detect your stack",
+    description: "whatever language and framework you already use"
+  },
+  {
+    title: "scaffold a search UI",
+    description: "a search box and results, wired into your app"
+  },
+  {
+    title: "ship it",
+    description: "build check passes, search is live with your real data"
+  }
+];
+
+// src/ui/Welcome.tsx
+import Image, { TerminalInfoContext, defaultTerminalInfo } from "ink-picture";
+import { jsx as jsx8, jsxs as jsxs9 } from "react/jsx-runtime";
+var IMAGE_PATH = join11(dirname8(fileURLToPath2(import.meta.url)), "algolia.png");
+var TERMINAL_INFO = {
+  ...defaultTerminalInfo,
+  supportsUnicode: true,
+  supportsColor: true
+};
+function SidebarItem({
+  title,
+  description
+}) {
+  return /* @__PURE__ */ jsxs9(Box10, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs9(Box10, { gap: 1, children: [
+      /* @__PURE__ */ jsx8(Text10, { color: COLORS.success, children: "\u2192" }),
+      /* @__PURE__ */ jsx8(Text10, { color: COLORS.strong, bold: true, children: title })
+    ] }),
+    /* @__PURE__ */ jsxs9(Box10, { flexDirection: "row", gap: 2, children: [
+      /* @__PURE__ */ jsx8(Spacer, {}),
+      /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: description })
+    ] })
+  ] });
+}
+function Welcome() {
+  const confirmStart = useWizard((s) => s.confirmStart);
+  const openLearnMore = useWizard((s) => s.openLearnMore);
+  const { rows } = useWindowSize5();
+  const actions = [
+    { label: "start wizard", run: confirmStart },
+    { label: "learn more", run: openLearnMore }
+  ];
+  const [index, setIndex] = useState7(0);
+  useInput3((input, key) => {
+    if (key.upArrow || input === "k") {
+      setIndex((i) => (i - 1 + actions.length) % actions.length);
+    } else if (key.downArrow || input === "j") {
+      setIndex((i) => (i + 1) % actions.length);
+    } else if (key.return) {
+      actions[index].run();
+    }
+  });
+  const scales = {
+    large: {
+      sidebar: { padding: { x: 4, y: 2 }, gap: 2 },
+      main: { padding: { x: 8, y: 4 } }
+    },
+    small: {
+      sidebar: { padding: { x: 2, y: 1 }, gap: 1 },
+      main: { padding: { x: 4, y: 2 } }
+    }
+  };
+  let layout = scales["large"];
+  if (rows < 30) {
+    layout = scales["small"];
+  }
+  return /* @__PURE__ */ jsxs9(Box10, { flexDirection: "row", justifyContent: "space-between", width: "100%", children: [
+    /* @__PURE__ */ jsx8(
+      Box10,
+      {
+        paddingY: layout.main.padding.y,
+        paddingX: layout.main.padding.x,
+        flexDirection: "column",
+        justifyContent: "center",
+        children: /* @__PURE__ */ jsxs9(Box10, { flexDirection: "column", gap: 2, children: [
+          /* @__PURE__ */ jsx8(TerminalInfoContext.Provider, { value: TERMINAL_INFO, children: /* @__PURE__ */ jsx8(
+            Image,
+            {
+              src: IMAGE_PATH,
+              objectFit: "contain",
+              alt: "Algolia",
+              width: 20,
+              height: 10,
+              protocol: "halfBlock"
+            }
+          ) }),
+          /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: "\u2726 From zero \u2192 working search in ~10 minutes" }),
+          /* @__PURE__ */ jsx8(Box10, { flexDirection: "column", children: actions.map((action, i) => /* @__PURE__ */ jsx8(
+            SelectRow,
+            {
+              highlighted: i === index,
+              highlightBackground: false,
+              label: action.label
+            },
+            action.label
+          )) }),
+          /* @__PURE__ */ jsxs9(Box10, { gap: 2, children: [
+            /* @__PURE__ */ jsxs9(Text10, { children: [
+              /* @__PURE__ */ jsx8(Text10, { color: COLORS.primary, children: "[\u2191] [\u2193]" }),
+              /* @__PURE__ */ jsx8(Text10, { color: COLORS.dim, children: " move" })
+            ] }),
+            /* @__PURE__ */ jsxs9(Text10, { children: [
+              /* @__PURE__ */ jsx8(Text10, { color: COLORS.primary, children: "[enter]" }),
+              /* @__PURE__ */ jsx8(Text10, { color: COLORS.dim, children: " confirm" })
+            ] })
+          ] })
+        ] })
+      }
+    ),
+    /* @__PURE__ */ jsxs9(
+      Box10,
+      {
+        backgroundColor: COLORS.bg.sidebar,
+        width: 40,
+        paddingY: layout.sidebar.padding.y,
+        paddingX: layout.sidebar.padding.x,
+        gap: layout.sidebar.gap,
+        flexDirection: "column",
+        justifyContent: "center",
+        children: [
+          /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: "WHAT THIS WIZARD WILL DO" }),
+          sidebarItems.map((i, idx) => /* @__PURE__ */ jsx8(SidebarItem, { title: i.title, description: i.description }, idx))
+        ]
+      }
+    )
+  ] });
+}
+
+// src/ui/LearnMore.tsx
+import { Fragment } from "react";
+import { Box as Box11, Text as Text11, useInput as useInput4, useWindowSize as useWindowSize6 } 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.";
+var accessItems = [
+  {
+    tag: "READ",
+    title: "Project files",
+    description: "reads manifests, configs & source to detect your stack. Read-only; nothing is uploaded."
+  },
+  {
+    tag: "WRITE",
+    title: "Code changes",
+    description: "creates & edits files (search UI, config) directly in your branch."
+  },
+  {
+    tag: "EXEC",
+    title: "Setup commands",
+    description: "runs dependency installs, the ingestion script & your own checks. Every command is shown in full and needs your OK; its output is shown as-is, so a command that prints a secret will display it."
+  },
+  {
+    tag: "NET",
+    title: "Algolia API",
+    description: "sends index settings & the records you pick to your Algolia app over HTTPS."
+  },
+  {
+    tag: "KEY",
+    title: "Credentials",
+    description: "writes your Algolia app id and a search-only key (safe to expose) to .env in your project."
+  }
+];
+var neverItems = [
+  "Send your source code to a model or third party",
+  "Commit or push to git",
+  "Run a command you haven't approved"
+];
+var policyLinks = [
+  { label: "Terms", url: "https://www.algolia.com/policies/terms" },
+  { label: "Privacy Policy", url: "https://www.algolia.com/policies/privacy" }
+];
+
+// src/ui/LearnMore.tsx
+import { jsx as jsx9, jsxs as jsxs10 } from "react/jsx-runtime";
+var TAG_COLORS = {
+  READ: COLORS.success,
+  WRITE: COLORS.badge,
+  EXEC: COLORS.danger,
+  NET: COLORS.accent,
+  KEY: COLORS.muted
+};
+var TAG_COLUMN_WIDTH = 10;
+var PADDING_X = 6;
+var NEVER_BOX_PAD_X = 2;
+function NeverLine({
+  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__ */ jsxs10(Text11, { color: COLORS.primary, children: [
+    /* @__PURE__ */ jsx9(Text11, { color: COLORS.danger, children: "\u2502" }),
+    " ".repeat(NEVER_BOX_PAD_X),
+    segments.map((s, i) => /* @__PURE__ */ jsx9(Text11, { color: s.color, bold: s.bold, children: s.text }, i)),
+    " ".repeat(rightPad),
+    /* @__PURE__ */ jsx9(Text11, { color: COLORS.danger, children: "\u2502" })
+  ] });
+}
+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);
+  useInput4((_input, key) => {
+    if (key.escape) backToHome();
+    else if (key.return) confirmStart();
+  });
+  return /* @__PURE__ */ jsxs10(
+    Box11,
+    {
+      flexDirection: "column",
+      paddingX: PADDING_X,
+      paddingY: 2,
+      width: "100%",
+      gap: 1,
+      children: [
+        /* @__PURE__ */ jsx9(Text11, { color: COLORS.strong, bold: true, children: "What algolia wizard accesses" }),
+        /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: accessIntro }),
+        /* @__PURE__ */ jsx9(Box11, { flexDirection: "column", children: accessItems.map((item) => /* @__PURE__ */ jsxs10(Box11, { flexDirection: "column", marginTop: 1, children: [
+          /* @__PURE__ */ jsx9(Text11, { color: COLORS.border, children: "\u2500".repeat(dividerWidth) }),
+          /* @__PURE__ */ jsxs10(Box11, { flexDirection: "row", gap: 1, marginTop: 1, children: [
+            /* @__PURE__ */ jsx9(Box11, { width: TAG_COLUMN_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx9(Text11, { color: TAG_COLORS[item.tag], bold: true, children: `[${item.tag}]` }) }),
+            /* @__PURE__ */ jsx9(Box11, { flexDirection: "column", children: /* @__PURE__ */ jsxs10(Text11, { color: COLORS.primary, children: [
+              /* @__PURE__ */ jsx9(Text11, { color: COLORS.strong, bold: true, children: item.title }),
+              /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: ` \u2014 ${item.description}` })
+            ] }) })
+          ] })
+        ] }, item.tag)) }),
+        /* @__PURE__ */ jsxs10(Box11, { marginTop: 1, flexDirection: "column", children: [
+          /* @__PURE__ */ jsx9(Text11, { color: COLORS.danger, children: `\u256D${"\u2500".repeat(Math.max(0, dividerWidth - 2))}\u256E` }),
+          /* @__PURE__ */ jsx9(NeverLine, { width: dividerWidth }),
+          /* @__PURE__ */ jsx9(
+            NeverLine,
+            {
+              width: dividerWidth,
+              segments: [{ text: "I NEVER", color: COLORS.danger, bold: true }]
+            }
+          ),
+          neverItems.map((item) => /* @__PURE__ */ jsxs10(Fragment, { children: [
+            /* @__PURE__ */ jsx9(NeverLine, { width: dividerWidth }),
+            /* @__PURE__ */ jsx9(
+              NeverLine,
+              {
+                width: dividerWidth,
+                segments: [
+                  { text: "\u2715", color: COLORS.danger },
+                  { text: " " },
+                  { text: item, color: COLORS.primary }
+                ]
+              }
+            )
+          ] }, item)),
+          /* @__PURE__ */ jsx9(NeverLine, { width: dividerWidth }),
+          /* @__PURE__ */ jsx9(Text11, { color: COLORS.danger, children: `\u2570${"\u2500".repeat(Math.max(0, dividerWidth - 2))}\u256F` })
+        ] }),
+        /* @__PURE__ */ jsx9(Box11, { marginTop: 1, flexDirection: "column", children: policyLinks.map((link) => /* @__PURE__ */ jsxs10(Box11, { flexDirection: "row", gap: 1, children: [
+          /* @__PURE__ */ jsx9(Text11, { color: COLORS.strong, bold: true, children: `${link.label}:` }),
+          /* @__PURE__ */ jsx9(Text11, { color: COLORS.accent, children: link.url })
+        ] }, link.label)) }),
+        /* @__PURE__ */ jsxs10(Box11, { marginTop: 1, flexDirection: "row", gap: 3, children: [
+          /* @__PURE__ */ jsxs10(Box11, { flexDirection: "row", gap: 1, children: [
+            /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: "[" }),
+            /* @__PURE__ */ jsx9(Text11, { color: COLORS.primary, children: "esc" }),
+            /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: "] back" })
+          ] }),
+          /* @__PURE__ */ jsxs10(Box11, { flexDirection: "row", gap: 1, children: [
+            /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: "[" }),
+            /* @__PURE__ */ jsx9(Text11, { color: COLORS.primary, children: "enter" }),
+            /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: "]" }),
+            /* @__PURE__ */ jsx9(Text11, { color: COLORS.success, bold: true, children: "start wizard" })
+          ] })
+        ] })
+      ]
+    }
+  );
+}
+
+// src/ui/Sidebar.tsx
+import { Box as Box14, Text as Text14 } from "ink";
+
+// src/ui/Steps.tsx
+import { Box as Box12, Text as Text12 } from "ink";
+import Spinner from "ink-spinner";
+import { jsx as jsx10, jsxs as jsxs11 } from "react/jsx-runtime";
+function Steps() {
+  const { steps } = useWizard();
+  const visibleSteps = steps.filter(isStepVisible);
+  return /* @__PURE__ */ jsx10(Box12, { flexDirection: "column", gap: 1, children: visibleSteps.map((s) => /* @__PURE__ */ jsx10(Box12, { flexDirection: "column", children: /* @__PURE__ */ jsxs11(Text12, { color: COLORS.status[s.status], children: [
+    s.status === "running" ? /* @__PURE__ */ jsx10(Spinner, { type: "dots" }) : MARKER[s.status],
+    " ",
+    s.title
+  ] }) }, s.id)) });
+}
+function CurrentStep() {
+  const { steps } = useWizard();
+  const currentStep = steps.filter(isStepVisible).find((s) => s.status === "running");
+  if (!currentStep) return null;
+  return /* @__PURE__ */ jsxs11(Text12, { color: COLORS.status.running, children: [
+    /* @__PURE__ */ jsx10(Spinner, { type: "dots" }),
+    " ",
+    ` ${currentStep.title}`
+  ] });
+}
+
+// src/ui/Progress.tsx
+import { Box as Box13, Text as Text13 } from "ink";
+import { jsx as jsx11, jsxs as jsxs12 } 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__ */ jsxs12(Box13, { flexDirection: "row", gap: 1, children: [
+    /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: "STEP" }),
+    /* @__PURE__ */ jsx11(Text13, { color: COLORS.strong, bold: true, children: activeStepNumber }),
+    /* @__PURE__ */ jsx11(Text13, { color: COLORS.strong, bold: true, children: "/" }),
+    /* @__PURE__ */ jsx11(Text13, { color: COLORS.strong, bold: true, children: visibleSteps.length })
+  ] });
+}
+
+// src/ui/copy/sidebar-commands.ts
+var sidebarCommands = [
+  { keyHint: "tab", description: "toggle logs" },
+  { keyHint: "esc", description: "exit wizard" }
+];
+
+// src/ui/Sidebar.tsx
+import { jsx as jsx12, jsxs as jsxs13 } from "react/jsx-runtime";
+function Sidebar() {
+  return /* @__PURE__ */ jsxs13(
+    Box14,
+    {
+      backgroundColor: "#14171E",
+      width: 30,
+      paddingX: 4,
+      paddingY: 2,
+      flexDirection: "column",
+      justifyContent: "space-between",
+      children: [
+        /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", gap: 1, children: [
+          /* @__PURE__ */ jsx12(Text14, { color: COLORS.muted, children: "PROGRESS" }),
+          /* @__PURE__ */ jsx12(Steps, {})
+        ] }),
+        /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", gap: 1, children: [
+          /* @__PURE__ */ jsx12(Progress, {}),
+          /* @__PURE__ */ jsx12(Box14, { flexDirection: "column", children: sidebarCommands.map((c) => {
+            return /* @__PURE__ */ jsxs13(Box14, { flexDirection: "row", gap: 1, children: [
+              /* @__PURE__ */ jsx12(Text14, { color: COLORS.primary, children: `[${c.keyHint}]` }),
+              /* @__PURE__ */ jsx12(Text14, { color: COLORS.muted, children: c.description })
+            ] });
+          }) })
+        ] })
+      ]
+    }
+  );
+}
+
+// src/ui/Ribbon.tsx
+import { Box as Box15, Text as Text15 } from "ink";
+import { jsx as jsx13, jsxs as jsxs14 } from "react/jsx-runtime";
+function Ribbon() {
+  const firstCommand = sidebarCommands[0];
+  return /* @__PURE__ */ jsxs14(
+    Box15,
+    {
+      backgroundColor: "#14171E",
+      flexDirection: "row",
+      justifyContent: "space-between",
+      paddingX: 2,
+      paddingY: 1,
+      children: [
+        /* @__PURE__ */ jsx13(Progress, {}),
+        /* @__PURE__ */ jsx13(CurrentStep, {}),
+        /* @__PURE__ */ jsxs14(Box15, { flexDirection: "row", gap: 1, children: [
+          /* @__PURE__ */ jsx13(Text15, { color: COLORS.primary, children: `[${firstCommand.keyHint}]` }),
+          /* @__PURE__ */ jsx13(Text15, { color: COLORS.muted, children: firstCommand.description })
+        ] })
+      ]
+    }
+  );
+}
+
+// src/ui/App.tsx
+import { useState as useState9 } from "react";
+
+// src/ui/Logs.tsx
+import { Box as Box16, Text as Text16, useInput as useInput5 } from "ink";
+import { jsx as jsx14, jsxs as jsxs15 } from "react/jsx-runtime";
+var KIND_COLOR = {
+  tool: COLORS.primary,
+  prompt: COLORS.badge
+};
+var STATUS_COLOR = {
+  running: COLORS.status.running,
+  error: COLORS.danger
+};
+function logNameColor(entry) {
+  return STATUS_COLOR[entry.status] ?? KIND_COLOR[entry.kind];
+}
+var ROW_GAP = 1;
+function truncate2(str, maxWidth) {
+  if (maxWidth <= 0) return "";
+  return str.length > maxWidth ? `${str.slice(0, maxWidth - 1)}\u2026` : str;
+}
+function rawInputText(input) {
+  if (input === void 0) return "";
+  const str = typeof input === "string" ? input : JSON.stringify(input);
+  if (!str || str === "{}") return "";
+  return str.replace(/\s+/g, " ").trim();
+}
+function formatTimestamp(ms) {
+  const d = new Date(ms);
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
+function Logs() {
+  const logs = useWizard((s) => s.logs);
+  const scroll = useScrollWindow({ itemCount: logs.length, followBottom: true });
+  useInput5((_input, key) => {
+    if (key.upArrow) scroll.scrollBy(-1);
+    else if (key.downArrow) scroll.scrollBy(1);
+  });
+  const visible = logs.slice(scroll.offset, scroll.offset + scroll.capacity);
+  return /* @__PURE__ */ jsxs15(Box16, { flexDirection: "column", paddingX: 4, paddingY: 2, flexGrow: 1, children: [
+    logs.length === 0 && /* @__PURE__ */ jsx14(Text16, { color: COLORS.dim, children: "No logs yet." }),
+    /* @__PURE__ */ jsx14(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);
+      const partCount = 2 + (rawPreview ? 1 : 0) + (durationText ? 1 : 0);
+      const gaps = (partCount - 1) * ROW_GAP;
+      let budget = scroll.width - timestamp.length - durationText.length - gaps;
+      const name = truncate2(entry.name, budget);
+      budget -= name.length;
+      const preview = rawPreview ? truncate2(rawPreview, budget) : "";
+      return /* @__PURE__ */ jsxs15(Box16, { flexDirection: "row", gap: ROW_GAP, children: [
+        /* @__PURE__ */ jsx14(Text16, { color: COLORS.dim, children: timestamp }),
+        /* @__PURE__ */ jsx14(Text16, { color: logNameColor(entry), wrap: "truncate", children: name }),
+        preview && /* @__PURE__ */ jsx14(Text16, { color: COLORS.dim, wrap: "truncate", children: preview }),
+        durationText && /* @__PURE__ */ jsx14(Text16, { color: COLORS.dim, children: durationText })
+      ] }, entry.id);
+    }) }),
+    /* @__PURE__ */ jsx14(Text16, { color: COLORS.dim, children: "\u2191/\u2193 scroll" })
+  ] });
+}
+
+// src/ui/Tips.tsx
+import { useEffect as useEffect3, useState as useState8 } from "react";
+import { Box as Box18, Text as Text18 } from "ink";
+import terminalLink from "terminal-link";
+
+// src/ui/Code.tsx
+import { Box as Box17, Text as Text17 } from "ink";
+import { jsx as jsx15 } 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);
+  return parts.map((part, i) => {
+    if (!part) return null;
+    if (part[0] === '"') {
+      const next = parts.slice(i + 1).find((p) => p.trim());
+      const isKey = next?.trimStart().startsWith(":");
+      return /* @__PURE__ */ jsx15(Text17, { color: isKey ? "cyan" : "green", children: part }, i);
+    }
+    if (part === "true" || part === "false" || part === "null") {
+      return /* @__PURE__ */ jsx15(Text17, { color: "magenta", children: part }, i);
+    }
+    if (/^-?\d/.test(part)) {
+      return /* @__PURE__ */ jsx15(Text17, { color: "yellow", children: part }, i);
+    }
+    if (/^[{}[\]:,]$/.test(part)) {
+      return /* @__PURE__ */ jsx15(Text17, { dimColor: true, children: part }, i);
+    }
+    return /* @__PURE__ */ jsx15(Text17, { children: part }, i);
+  });
+}
+function Code({ children }) {
+  return /* @__PURE__ */ jsx15(Box17, { children: /* @__PURE__ */ jsx15(Text17, { children: highlightJson(children) }) });
+}
+
+// src/ui/copy/tips.ts
+var tips = [
+  {
+    id: "apps-and-indices",
+    title: "An Application is like your library. Indices are the books in it.",
+    chunks: [
+      {
+        type: "text",
+        value: "Applications hold your API keys and Indices."
+      },
+      {
+        type: "text",
+        value: "Each index is a searchable collection of records (think: products, articles, orders, concerts)."
+      }
+    ]
+  },
+  {
+    id: "records-are-json",
+    title: "A Record is a JSON object inside of an index.",
+    chunks: [
+      {
+        type: "text",
+        value: "Every object you index is just a JSON document with a unique objectID."
+      },
+      {
+        type: "text",
+        value: "No fixed schema, no hard requirements."
+      },
+      {
+        type: "text",
+        value: "Everything else is up to you:"
+      },
+      {
+        type: "code",
+        value: JSON.stringify(
+          {
+            objectID: "sku_48213",
+            name: "Trail Running Shoe",
+            brand: "Northline",
+            categories: ["Footwear", "Running", "Mens"],
+            price: 129.99,
+            in_stock: true,
+            rating: 4.6
+          },
+          null,
+          2
+        )
+      }
+    ]
+  },
+  {
+    id: "speed",
+    title: "Speed isn't a feature, it's our business",
+    chunks: [
+      {
+        type: "text",
+        value: "Algolia's engine processes most search queries in 1 to 50 milliseconds."
+      },
+      {
+        type: "text",
+        value: "This is why our search-as-you-type experience feels instant."
+      }
+    ]
+  },
+  {
+    id: "searchable-attributes",
+    title: "Searchable attributes are your relevance dial #1",
+    chunks: [
+      {
+        type: "text",
+        value: "Order matters. Attributes listed first in"
+      },
+      { type: "codeword", value: "searchableAttributes" },
+      { type: "text", value: "carry more ranking weight." },
+      {
+        type: "text",
+        value: "This is the single highest-leverage lever new users don't know exists."
+      }
+    ]
+  },
+  {
+    id: "facets",
+    title: "Facets aren't just filters, they help build your UI",
+    chunks: [
+      { type: "codeword", value: "attributesForFaceting" },
+      {
+        type: "text",
+        value: "unlock category sidebars, price sliders, tag clouds without extra backend work."
+      }
+    ]
+  },
+  {
+    id: "test-relevance",
+    title: "Test relevance in the dashboard before you write a line of ranking code",
+    chunks: [
+      {
+        type: "text",
+        value: "Our Search dashboard has a live preview where you can browse results."
+      },
+      {
+        type: "text",
+        value: "Tune your settings and see how it alters your results in"
+      },
+      {
+        type: "link",
+        value: "real-time.",
+        href: "https://dashboard.algolia.com/explorer/browse"
+      }
+    ]
+  },
+  {
+    id: "search-analytics",
+    title: "Search Analytics helps you discover opportunities",
+    chunks: [
+      {
+        type: "text",
+        value: "No click results for a particular query? Low click-through rates for another?"
+      },
+      {
+        type: "text",
+        value: "Our Search Analytics will help you identify synonyms, rules or other relevancy settings to improve your results."
+      }
+    ]
+  },
+  {
+    id: "recommend",
+    title: "Let Algolia act as your recommendation engine",
+    chunks: [
+      {
+        type: "text",
+        value: "Beyond search, Algolia Recommend runs models trained on your existing indices and event data to power your recommendation engine."
+      },
+      {
+        type: "text",
+        value: "You can improve engagement with related, popular or visually similar items."
+      }
+    ]
+  }
+];
+var tipsById = Object.fromEntries(
+  tips.map((tip) => [tip.id, tip])
+);
+function tipsByIds(ids) {
+  return ids.map((id) => tipsById[id]).filter((tip) => tip !== void 0);
+}
+
+// src/ui/Tips.tsx
+import { jsx as jsx16, jsxs as jsxs16 } from "react/jsx-runtime";
+var TICK_MS = 16;
+var CHUNK_HOLD_MS = 2e3;
+var HOLD_MS = 8e3;
+function TipTitle({ children }) {
+  return /* @__PURE__ */ jsxs16(Box18, { gap: 1, children: [
+    /* @__PURE__ */ jsx16(Text18, { color: "cyan", children: "\u2726" }),
+    /* @__PURE__ */ jsx16(Text18, { color: "white", bold: true, children })
+  ] });
+}
+function InlineSegment({ segment }) {
+  switch (segment.type) {
+    case "highlight":
+      return /* @__PURE__ */ jsx16(Text18, { color: COLORS.success, children: segment.value });
+    case "link":
+      return /* @__PURE__ */ jsx16(Text18, { color: "cyan", underline: true, children: segment.href ? terminalLink(segment.value, segment.href) : segment.value });
+    case "codeword":
+      return /* @__PURE__ */ jsx16(Text18, { color: COLORS.highlight.fg, backgroundColor: COLORS.highlight.bg, children: segment.value });
+    default:
+      return /* @__PURE__ */ jsx16(Text18, { color: COLORS.muted, children: segment.value });
+  }
+}
+function TipContent({
+  chunks,
+  revealed
+}) {
+  let remaining = revealed;
+  const slices = chunks.map((chunk) => {
+    const slice = chunk.value.slice(0, Math.max(0, remaining));
+    remaining -= chunk.value.length;
+    return slice;
+  });
+  const blocks = [];
+  for (let i = 0; i < chunks.length; i++) {
+    const chunk = chunks[i];
+    const slice = slices[i];
+    if (!slice) continue;
+    const segment = {
+      type: chunk.type,
+      value: slice,
+      href: chunk.type === "link" ? chunk.href : void 0
+    };
+    if (chunk.type === "code") {
+      blocks.push({ type: "code", segment });
+      continue;
+    }
+    const last = blocks[blocks.length - 1];
+    if (last?.type === "inline") {
+      last.segments.push(segment);
+    } else {
+      blocks.push({ type: "inline", segments: [segment] });
+    }
+  }
+  return /* @__PURE__ */ jsx16(Box18, { flexDirection: "column", marginLeft: 2, gap: 1, children: blocks.map(
+    (block, i) => block.type === "code" ? /* @__PURE__ */ jsx16(Code, { children: block.segment.value }, i) : /* @__PURE__ */ jsx16(Text18, { children: block.segments.map((segment, j) => /* @__PURE__ */ jsxs16(Text18, { children: [
+      j > 0 && " ",
+      /* @__PURE__ */ jsx16(InlineSegment, { segment })
+    ] }, j)) }, i)
+  ) });
+}
+var progress = { stepId: null, tipIndex: 0, revealed: 0 };
+function Tips({ stepId, ids }) {
+  const tips2 = tipsByIds(ids);
+  const resuming = progress.stepId === stepId;
+  if (!resuming) {
+    progress.stepId = stepId;
+    progress.tipIndex = 0;
+    progress.revealed = 0;
+  }
+  const [tipIndex, setTipIndex] = useState8(resuming ? progress.tipIndex : 0);
+  const [revealed, setRevealed] = useState8(resuming ? progress.revealed : 0);
+  const tip = tips2.length > 0 ? tips2[tipIndex % tips2.length] : void 0;
+  const contentLength = tip?.chunks.reduce((sum, c) => sum + c.value.length, 0) ?? 0;
+  const totalLength = (tip?.title.length ?? 0) + contentLength;
+  const segments = tip ? [
+    { type: "title", length: tip.title.length },
+    ...tip.chunks.map((c) => ({ type: c.type, length: c.value.length }))
+  ] : [];
+  const noPauseAfterText = [
+    "highlight",
+    "link",
+    "codeword"
+  ];
+  const chunkBoundaries = [];
+  let cumulative = 0;
+  for (let i = 0; i < segments.length - 1; i++) {
+    cumulative += segments[i].length;
+    const skipPause = noPauseAfterText.includes(
+      segments[i + 1].type
+    );
+    if (!skipPause) chunkBoundaries.push(cumulative);
+  }
+  useEffect3(() => {
+    if (tips2.length === 0) return;
+    if (revealed < totalLength) {
+      const delay2 = chunkBoundaries.includes(revealed) ? CHUNK_HOLD_MS : TICK_MS;
+      const timer2 = setTimeout(() => {
+        setRevealed((r) => {
+          const next = r + 1;
+          progress.revealed = next;
+          return next;
+        });
+      }, delay2);
+      return () => clearTimeout(timer2);
+    }
+    const timer = setTimeout(() => {
+      setTipIndex((i) => {
+        const next = (i + 1) % tips2.length;
+        progress.tipIndex = next;
+        return next;
+      });
+      setRevealed(0);
+      progress.revealed = 0;
+    }, HOLD_MS);
+    return () => clearTimeout(timer);
+  }, [revealed, totalLength, tips2.length]);
+  if (!tip) return null;
+  const titleRevealed = tip.title.slice(0, revealed);
+  const contentRevealed = Math.max(0, revealed - tip.title.length);
+  return /* @__PURE__ */ jsxs16(Box18, { flexDirection: "column", marginBottom: 1, gap: 1, children: [
+    /* @__PURE__ */ jsx16(TipTitle, { children: titleRevealed }),
+    /* @__PURE__ */ jsx16(TipContent, { chunks: tip.chunks, revealed: contentRevealed })
+  ] });
+}
+
+// src/ui/App.tsx
+import { jsx as jsx17, jsxs as jsxs17 } from "react/jsx-runtime";
+function App() {
+  const {
+    phase,
+    error,
+    homeScreen,
+    currentStepIndex,
+    steps,
+    inputReq,
+    user,
+    workflow
+  } = useWizard();
+  const { exit } = useApp();
+  const { columns, rows } = useWindowSize7();
+  const [showLogs, setShowLogs] = useState9(false);
+  const finished = phase === "done" || phase === "error";
+  const currentStep = steps[currentStepIndex];
+  const stepDef = workflow ? getWorkflow(workflow.id)?.steps.find((s) => s.id === currentStep?.id) : void 0;
+  const tipIds = stepDef?.tips ?? [];
+  const stepHasTips = tipIds.length > 0;
+  const isAwaitingUserInput = phase === "awaitingInput" && !!inputReq;
+  const isCommandApprovalPrompt = isAwaitingUserInput && inputReq?.promptType === "commandApproval";
+  const showTips = stepHasTips && (phase === "running" || isCommandApprovalPrompt);
+  const showNoticesInMain = !stepHasTips;
+  const showNotices = !isAwaitingUserInput;
+  useInput6(
+    (_input, key) => {
+      if (key.return) {
+        exit();
+      }
+    },
+    { isActive: finished }
+  );
+  useInput6((_input, key) => {
+    if (phase === "idle" || phase === "authenticating") return;
+    if (key.tab) {
+      setShowLogs(!showLogs);
+      track("AI Wizard Interaction", {
+        context: "global",
+        key: "tab",
+        currentStep: currentStep?.id
+      });
+    }
+  });
+  const escOwnedElsewhere = phase === "idle" || phase === "authenticating" || phase === "awaitingInput" && (inputReq?.promptType === "enterToContinue" || inputReq?.promptType === "commandApproval");
+  useInput6((_input, key) => {
+    if (escOwnedElsewhere) return;
+    if (key.escape) {
+      track("AI Wizard Interaction", {
+        context: "global",
+        key: "esc",
+        currentStep: currentStep?.id ?? phase
+      });
+      exit();
+    }
+  });
+  const mainWindowVisible = phase === "authenticating" || phase === "preflight" || phase === "running" || phase === "awaitingInput" || phase === "error" || phase === "done";
+  const flexDirection = columns > 90 ? "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__ */ jsxs17(
+      Box19,
+      {
+        backgroundColor: COLORS.bg.main,
+        flexDirection: "row",
+        width: columns,
+        height: scrollsPastViewport ? void 0 : rows,
+        overflow: scrollsPastViewport ? "visible" : "hidden",
+        children: [
+          mainWindowVisible && /* @__PURE__ */ jsxs17(
+            Box19,
+            {
+              flexDirection,
+              width: "100%",
+              maxHeight: rows,
+              justifyContent: "space-between",
+              children: [
+                showLogs ? /* @__PURE__ */ jsx17(Logs, {}) : /* @__PURE__ */ jsxs17(
+                  Box19,
+                  {
+                    flexDirection: "column",
+                    paddingX: 4,
+                    paddingY: 2,
+                    width: showSidebar ? 70 : "100%",
+                    flexGrow: 1,
+                    gap: 1,
+                    children: [
+                      /* @__PURE__ */ jsxs17(Box19, { flexGrow: 2, flexDirection: "column", children: [
+                        phase === "preflight" && !user && /* @__PURE__ */ jsx17(Box19, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs17(Text19, { color: COLORS.strong, bold: true, children: [
+                          /* @__PURE__ */ jsx17(Spinner2, { type: "dots" }),
+                          " Signing in to Algolia"
+                        ] }) }),
+                        phase === "preflight" && user && /* @__PURE__ */ jsx17(Box19, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs17(Text19, { color: COLORS.strong, bold: true, children: [
+                          /* @__PURE__ */ jsx17(Spinner2, { type: "dots" }),
+                          " Getting things ready"
+                        ] }) }),
+                        phase === "authenticating" && /* @__PURE__ */ jsxs17(Box19, { flexDirection: "column", marginBottom: 1, children: [
+                          /* @__PURE__ */ jsxs17(Text19, { color: COLORS.strong, bold: true, children: [
+                            /* @__PURE__ */ jsx17(Spinner2, { type: "dots" }),
+                            " Signing in to Algolia"
+                          ] }),
+                          /* @__PURE__ */ jsx17(Text19, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
+                        ] }),
+                        /* @__PURE__ */ jsx17(CliOutput, {}),
+                        showTips && currentStep && /* @__PURE__ */ jsx17(Tips, { stepId: currentStep.id, ids: tipIds }),
+                        showNoticesInMain && showNotices && /* @__PURE__ */ jsx17(Notices, { showAll: true, border: false }),
+                        !showTips && /* @__PURE__ */ jsx17(PromptInput, {}),
+                        phase === "error" && error && /* @__PURE__ */ jsx17(Box19, { marginTop: 1, children: /* @__PURE__ */ jsxs17(Text19, { color: COLORS.status.error, children: [
+                          "\u2716 ",
+                          error
+                        ] }) })
+                      ] }),
+                      !showNoticesInMain && showNotices && /* @__PURE__ */ jsx17(Notices, {}),
+                      showTips && /* @__PURE__ */ jsx17(PromptInput, {})
+                    ]
+                  }
+                ),
+                showSidebar ? /* @__PURE__ */ jsx17(Sidebar, {}) : /* @__PURE__ */ jsx17(Ribbon, {})
+              ]
+            }
+          ),
+          phase === "idle" && (homeScreen === "learnMore" ? /* @__PURE__ */ jsx17(LearnMore, {}) : /* @__PURE__ */ jsx17(Welcome, {}))
+        ]
+      }
+    )
+  );
+}
+
+// src/lib/envAppId.ts
+import { readFile as readFile7 } from "node:fs/promises";
+import { join as join12 } from "node:path";
+var ENV_FILES = [".env", ".env.local"];
+var APP_ID_LINE = /^[ \t]*(?:export[ \t]+)?([A-Z0-9_]*ALGOLIA_APP(?:LICATION)?_ID)[ \t]*=[ \t]*(.*)$/gm;
+async function findEnvApplicationId(root = process.cwd()) {
+  for (const file of ENV_FILES) {
+    let content;
+    try {
+      content = await readFile7(join12(root, file), "utf8");
+    } catch (err) {
+      if (err.code !== "ENOENT") {
+        logger.warn(
+          { file, err },
+          "could not read env file for an application id"
+        );
+      }
+      continue;
+    }
+    for (const [, name, raw] of content.matchAll(APP_ID_LINE)) {
+      const id = readValue(raw);
+      if (id) {
+        logger.info({ file, name, app: id }, "found an application id in env");
+        return { id, name, file };
+      }
+    }
+  }
+  return null;
+}
+function readValue(raw) {
+  const trimmed = raw.trim();
+  const quoted = trimmed.match(/^(['"])(.*)\1/);
+  const value = quoted ? quoted[2].trim() : trimmed.replace(/\s+#.*$/, "").trim();
+  return value.length > 0 && !value.startsWith("<") ? value : null;
+}
+
+// src/lib/algoliaAppPicker.ts
+function secondaryFor(app) {
+  return app.plan ? { kind: "badge", value: app.plan } : void 0;
+}
+function labelFor(app) {
+  return app.name.trim() ? `${app.name} \u2014 ${app.id}` : app.id;
+}
+function selectAndReport(app) {
+  useWizard.getState().pushCliOutput(
+    "stdout",
+    `Selecting ${labelFor(app)} \u2014 provisioning its API key\u2026`
+  );
+  return selectApplication(app.id);
+}
+async function promptForApplication(leadIn = []) {
+  const store = useWizard.getState();
+  const apps = await listApplications();
+  if (apps.length === 0) {
+    throw new Error(
+      "This Algolia account has no applications. Create one in the Algolia dashboard, or with `npx @algolia/cli@latest application create`, then restart the wizard."
+    );
+  }
+  if (apps.length === 1) {
+    const only = apps[0];
+    logger.info(
+      { app: only.id },
+      "single application on the account; selecting it"
+    );
+    for (const line of leadIn) store.pushCliOutput("stdout", line);
+    return selectAndReport(only);
+  }
+  const messages = [
+    ...leadIn,
+    "Which Algolia application should the wizard work in?"
+  ];
+  for (; ; ) {
+    const choice = await store.requestUserInput({
+      prompt: "Select an application",
+      promptType: "multipleChoice",
+      options: apps.map(labelFor),
+      secondary: apps.map(secondaryFor),
+      messages
+    });
+    const chosen = apps.find((app) => labelFor(app) === choice);
+    if (!chosen) {
+      throw new Error("Application picker received an unexpected selection");
+    }
+    try {
+      return await selectAndReport(chosen);
+    } catch (err) {
+      logger.warn(
+        { app: chosen.id, err: err.message },
+        "application select failed; re-prompting"
+      );
+      messages.push(
+        `Could not select \u201C${labelFor(chosen)}\u201D. It may have been removed \u2014 pick another.`
+      );
+    }
+  }
+}
+async function confirmEnvApplication(env, current) {
+  const useEnv = `Use ${env.id} (from ${env.file})`;
+  const choice = await useWizard.getState().requestUserInput({
+    prompt: "Select an application",
+    promptType: "multipleChoice",
+    options: [
+      useEnv,
+      current ? `Use ${labelFor(current)} (already selected)` : "Pick a different application"
+    ],
+    messages: [
+      `${env.file} already sets ${env.name}=${env.id}.`,
+      "Which Algolia application should the wizard work in?"
+    ]
+  });
+  return choice === useEnv;
+}
+async function selectEnvApplication(env) {
+  try {
+    return await selectAndReport({ id: env.id, name: "" });
+  } catch (err) {
+    logger.warn(
+      { app: env.id, err: err.message },
+      "could not select the application named in env; falling back to the picker"
+    );
+    return promptForApplication([
+      `Could not select ${env.id} from ${env.file} \u2014 it may have been removed, or this account may not have access to it.`
+    ]);
+  }
+}
+async function ensureApplication() {
+  const current = await currentApplication();
+  const env = await findEnvApplicationId();
+  if (env && env.id !== current?.id && await confirmEnvApplication(env, current)) {
+    return selectEnvApplication(env);
+  }
+  return current ?? await promptForApplication();
+}
+
 // src/lib/seed.ts
 var projectScan2 = {
   languages: [{ name: "TypeScript", version: "5.7.2" }],