@algolia/wizard 0.23.0 → 0.24.0-rc.117.212

package/dist/main.js

@@ -4,7 +4,7 @@
 import { render } from "ink";
 
 // src/ui/App.tsx
-import { Box as Box17, Text as Text17, useApp, useInput as useInput7, useWindowSize as useWindowSize8 } from "ink";
+import { Box as Box19, Text as Text19, useApp, useInput as useInput7, useWindowSize as useWindowSize7 } from "ink";
 
 // src/core/store.ts
 import { create } from "zustand";
@@ -251,6 +251,7 @@ var useWizard = create((set, get) => ({
   _noticeTimer: null,
   cliOutput: [],
   targetIndex: null,
+  writtenFiles: [],
   logs: [],
   error: null,
   inputReq: null,
@@ -344,6 +345,8 @@ var useWizard = create((set, get) => ({
   })),
   clearCliOutput: () => set({ cliOutput: [] }),
   setTargetIndex: (index) => set({ targetIndex: index }),
+  recordWrittenFile: (path) => set((s) => ({ writtenFiles: [...s.writtenFiles, path] })),
+  clearWrittenFiles: () => set({ writtenFiles: [] }),
   logStart: (kind, name, input) => {
     const id = nanoid();
     set((s) => ({
@@ -391,6 +394,7 @@ var useWizard = create((set, get) => ({
       notices: [],
       cliOutput: [],
       targetIndex: null,
+      writtenFiles: [],
       logs: [],
       error: null,
       inputReq: null,
@@ -484,7 +488,7 @@ function CliOutput() {
 }
 
 // src/ui/Notices.tsx
-import { Box as Box3, Text as Text3, useWindowSize as useWindowSize3 } from "ink";
+import { Box as Box3, Text as Text3 } from "ink";
 import { useEffect as useEffect2, useState as useState2 } from "react";
 
 // src/ui/Table.tsx
@@ -543,31 +547,6 @@ var truncate = (s, width) => s.length <= width ? s : width <= 1 ? s.slice(0, wid
 // src/ui/Notices.tsx
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 var AGENT_MARKER = "\u2726";
-var RESERVED_ROWS2 = 14;
-var PANEL_TEXT_WIDTH2 = 45;
-function messageLineCount(text) {
-  return Math.max(1, Math.ceil(text.length / PANEL_TEXT_WIDTH2));
-}
-function noticeLineCount(notice) {
-  const messageLines = (notice.messages ?? []).reduce((sum, m) => {
-    const text = typeof m === "string" ? m : m.text;
-    return sum + messageLineCount(text);
-  }, 0);
-  const tableLines = notice.table ? notice.table.rows.length + 4 : 0;
-  return messageLines + tableLines;
-}
-function fitVisibleNotices(notices, windowRows) {
-  const budget = Math.max(windowRows - RESERVED_ROWS2, 3);
-  let used = 0;
-  let count = 0;
-  for (let i = notices.length - 1; i >= 0; i--) {
-    const height = noticeLineCount(notices[i]) + (count > 0 ? 1 : 0);
-    if (count > 0 && used + height > budget) break;
-    used += height;
-    count++;
-  }
-  return notices.slice(notices.length - count);
-}
 var PULSE_STEPS = 12;
 var PULSE_STEP_MS = 150;
 var PULSE_COLORS = Array.from(
@@ -590,8 +569,7 @@ function parseHex(hex) {
 }
 function Notices() {
   const notices = useWizard((s) => s.notices);
-  const { rows: windowRows } = useWindowSize3();
-  const visible = fitVisibleNotices(notices, windowRows);
+  const latest = notices[notices.length - 1];
   const [pulseStep, setPulseStep] = useState2(0);
   useEffect2(() => {
     let direction = 1;
@@ -605,30 +583,40 @@ function Notices() {
     }, PULSE_STEP_MS);
     return () => clearInterval(id);
   }, []);
-  if (!visible.length) return null;
+  if (!latest) return null;
   const pulseColor = PULSE_COLORS[pulseStep];
-  return /* @__PURE__ */ jsx2(Box3, { flexDirection: "column", gap: 1, marginBottom: 1, children: visible.map((notice, i) => {
-    const isLatest = i === visible.length - 1;
-    return /* @__PURE__ */ jsxs2(Box3, { flexDirection: "column", children: [
-      notice.messages?.map((m, j) => {
-        const line = typeof m === "string" ? { text: m } : m;
-        const prefix = j === 0 ? `${AGENT_MARKER} ` : "  ";
-        return /* @__PURE__ */ jsxs2(
-          Text3,
-          {
-            color: isLatest && !line.color ? pulseColor : line.color ?? COLORS.dim,
-            bold: line.bold,
-            children: [
-              prefix,
-              line.text
-            ]
-          },
-          `notice-${i}-${j}`
-        );
-      }),
-      notice.table && /* @__PURE__ */ jsx2(Table, { columns: notice.table.columns, rows: notice.table.rows })
-    ] }, `notice-${i}`);
-  }) });
+  return /* @__PURE__ */ jsxs2(
+    Box3,
+    {
+      borderColor: COLORS.border,
+      borderStyle: "single",
+      borderBackgroundColor: COLORS.bg.main,
+      borderLeft: false,
+      borderRight: false,
+      borderBottom: false,
+      paddingTop: 1,
+      flexDirection: "column",
+      children: [
+        latest.messages?.map((m, j) => {
+          const line = typeof m === "string" ? { text: m } : m;
+          const prefix = j === 0 ? `${AGENT_MARKER} ` : "  ";
+          return /* @__PURE__ */ jsxs2(
+            Text3,
+            {
+              color: !line.color ? pulseColor : line.color ?? COLORS.dim,
+              bold: line.bold,
+              children: [
+                prefix,
+                line.text
+              ]
+            },
+            `notice-${j}`
+          );
+        }),
+        latest.table && /* @__PURE__ */ jsx2(Table, { columns: latest.table.columns, rows: latest.table.rows })
+      ]
+    }
+  );
 }
 
 // src/ui/PromptInput.tsx
@@ -709,11 +697,11 @@ function CommandApproval({
 }
 
 // src/ui/SelectPrompt.tsx
-import { Box as Box8, Text as Text8, useInput as useInput2, useWindowSize as useWindowSize5 } from "ink";
+import { Box as Box8, Text as Text8, useInput as useInput2, useWindowSize as useWindowSize4 } from "ink";
 import { useLayoutEffect as useLayoutEffect2, useRef as useRef3, useState as useState4 } from "react";
 
 // src/ui/ScrollView.tsx
-import { Box as Box6, Text as Text6, measureElement as measureElement2, useWindowSize as useWindowSize4 } from "ink";
+import { Box as Box6, Text as Text6, measureElement as measureElement2, useWindowSize as useWindowSize3 } from "ink";
 import { useCallback, useLayoutEffect, useRef as useRef2, useState as useState3 } from "react";
 import { jsxs as jsxs5 } from "react/jsx-runtime";
 var INDICATOR_ROWS = 2;
@@ -730,7 +718,7 @@ function useScrollWindow({
   followBottom = false
 }) {
   const viewportRef = useRef2(null);
-  const { columns } = useWindowSize4();
+  const { columns } = useWindowSize3();
   const [size, setSize] = useState3(
     null
   );
@@ -871,7 +859,7 @@ function SelectPrompt({
   if (multi) hints.push({ key: "[space]", label: "select" });
   hints.push({ key: "[enter]", label: "confirm" });
   const containerRef = useRef3(null);
-  const { columns } = useWindowSize5();
+  const { columns } = useWindowSize4();
   const [width, setWidth] = useState4(columns);
   useLayoutEffect2(() => {
     if (!containerRef.current) return;
@@ -1100,7 +1088,7 @@ function PromptInput() {
 import { dirname as dirname2, join as join3 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { useState as useState6 } from "react";
-import { Box as Box10, Spacer, Text as Text10, useInput as useInput4, useWindowSize as useWindowSize6 } from "ink";
+import { Box as Box10, Spacer, Text as Text10, useInput as useInput4, useWindowSize as useWindowSize5 } from "ink";
 
 // src/ui/copy/welcome.ts
 var sidebarItems = [
@@ -1153,7 +1141,7 @@ function SidebarItem({
 function Welcome() {
   const confirmStart = useWizard((s) => s.confirmStart);
   const openLearnMore = useWizard((s) => s.openLearnMore);
-  const { rows } = useWindowSize6();
+  const { rows } = useWindowSize5();
   const actions = [
     { label: "start wizard", run: confirmStart },
     { label: "learn more", run: openLearnMore }
@@ -1246,7 +1234,7 @@ function Welcome() {
 
 // src/ui/LearnMore.tsx
 import { Fragment as Fragment2 } from "react";
-import { Box as Box11, Text as Text11, useInput as useInput5, useWindowSize as useWindowSize7 } from "ink";
+import { Box as Box11, Text as Text11, useInput as useInput5, 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.";
@@ -1259,7 +1247,7 @@ var accessItems = [
   {
     tag: "WRITE",
     title: "Code changes",
-    description: "creates & edits files (search UI, config) in a throwaway git worktree \u2014 your checkout is never touched."
+    description: "creates & edits files (search UI, config) directly in your branch."
   },
   {
     tag: "EXEC",
@@ -1274,7 +1262,7 @@ var accessItems = [
   {
     tag: "KEY",
     title: "Credentials",
-    description: "writes your Algolia app id and a search-only key (safe to expose) to .env in the worktree."
+    description: "writes your Algolia app id and a search-only key (safe to expose) to .env in your project."
   }
 ];
 var neverItems = [
@@ -1316,7 +1304,7 @@ function NeverLine({
 function LearnMore() {
   const confirmStart = useWizard((s) => s.confirmStart);
   const backToHome = useWizard((s) => s.backToHome);
-  const { columns } = useWindowSize7();
+  const { columns } = useWindowSize6();
   const dividerWidth = Math.max(0, columns - PADDING_X * 2);
   useInput5((_input, key) => {
     if (key.escape) backToHome();
@@ -1526,7 +1514,7 @@ function Ribbon() {
 }
 
 // src/ui/App.tsx
-import { useState as useState7 } from "react";
+import { useState as useState8 } from "react";
 
 // src/ui/Logs.tsx
 import { Box as Box16, Text as Text16, useInput as useInput6 } from "ink";
@@ -1776,13 +1764,287 @@ function track(event, payload) {
   });
 }
 
+// src/ui/Tips.tsx
+import { useEffect as useEffect3, useState as useState7 } 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 = [
+  {
+    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
+        )
+      }
+    ]
+  },
+  {
+    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."
+      }
+    ]
+  }
+];
+
+// 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)
+  ) });
+}
+function Tips() {
+  const [tipIndex, setTipIndex] = useState7(0);
+  const [revealed, setRevealed] = useState7(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 (!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 })
+  ] });
+}
+
 // src/ui/App.tsx
-import { jsx as jsx15, jsxs as jsxs16 } from "react/jsx-runtime";
+import { jsx as jsx17, jsxs as jsxs17 } from "react/jsx-runtime";
 function App() {
-  const { phase, error, homeScreen, currentStepIndex, steps, inputReq } = useWizard();
+  const { phase, error, homeScreen, currentStepIndex, steps, inputReq, notices } = useWizard();
   const { exit } = useApp();
-  const { columns, rows } = useWindowSize8();
-  const [showLogs, setShowLogs] = useState7(false);
+  const { columns, rows } = useWindowSize7();
+  const [showLogs, setShowLogs] = useState8(false);
   const finished = phase === "done" || phase === "error";
   const currentStep = steps[currentStepIndex];
   useInput7(
@@ -1824,8 +2086,8 @@ function App() {
     /* 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__ */ jsxs16(
-      Box17,
+    /* @__PURE__ */ jsxs17(
+      Box19,
       {
         backgroundColor: COLORS.bg.main,
         flexDirection: "row",
@@ -1833,42 +2095,46 @@ function App() {
         height: scrollsPastViewport ? void 0 : rows,
         overflow: scrollsPastViewport ? "visible" : "hidden",
         children: [
-          mainWindowVisible && /* @__PURE__ */ jsxs16(
-            Box17,
+          mainWindowVisible && /* @__PURE__ */ jsxs17(
+            Box19,
             {
               flexDirection,
               width: "100%",
               maxHeight: rows,
               justifyContent: "space-between",
               children: [
-                showLogs ? /* @__PURE__ */ jsx15(Logs, {}) : /* @__PURE__ */ jsxs16(
-                  Box17,
+                showLogs ? /* @__PURE__ */ jsx17(Logs, {}) : /* @__PURE__ */ jsxs17(
+                  Box19,
                   {
                     flexDirection: "column",
                     paddingX: 4,
                     paddingY: 2,
                     width: showSidebar ? 70 : "100%",
                     flexGrow: 1,
+                    gap: 1,
                     children: [
-                      phase === "authenticating" && /* @__PURE__ */ jsxs16(Box17, { flexDirection: "column", marginBottom: 1, children: [
-                        /* @__PURE__ */ jsx15(Text17, { color: COLORS.strong, bold: true, children: "Signing in to Algolia" }),
-                        /* @__PURE__ */ jsx15(Text17, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
+                      /* @__PURE__ */ jsxs17(Box19, { flexGrow: 2, flexDirection: "column", children: [
+                        phase === "authenticating" && /* @__PURE__ */ jsxs17(Box19, { flexDirection: "column", marginBottom: 1, children: [
+                          /* @__PURE__ */ jsx17(Text19, { color: COLORS.strong, bold: true, children: "Signing in to Algolia" }),
+                          /* @__PURE__ */ jsx17(Text19, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
+                        ] }),
+                        /* @__PURE__ */ jsx17(CliOutput, {}),
+                        notices.length > 0 && phase === "running" && /* @__PURE__ */ jsx17(Tips, {}),
+                        /* @__PURE__ */ jsx17(PromptInput, {}),
+                        phase === "error" && error && /* @__PURE__ */ jsx17(Box19, { marginTop: 1, children: /* @__PURE__ */ jsxs17(Text19, { color: COLORS.status.error, children: [
+                          "\u2716 ",
+                          error
+                        ] }) })
                       ] }),
-                      /* @__PURE__ */ jsx15(CliOutput, {}),
-                      /* @__PURE__ */ jsx15(Notices, {}),
-                      /* @__PURE__ */ jsx15(PromptInput, {}),
-                      phase === "error" && error && /* @__PURE__ */ jsx15(Box17, { marginTop: 1, children: /* @__PURE__ */ jsxs16(Text17, { color: COLORS.status.error, children: [
-                        "\u2716 ",
-                        error
-                      ] }) })
+                      /* @__PURE__ */ jsx17(Notices, {})
                     ]
                   }
                 ),
-                showSidebar ? /* @__PURE__ */ jsx15(Sidebar, {}) : /* @__PURE__ */ jsx15(Ribbon, {})
+                showSidebar ? /* @__PURE__ */ jsx17(Sidebar, {}) : /* @__PURE__ */ jsx17(Ribbon, {})
               ]
             }
           ),
-          phase === "idle" && (homeScreen === "learnMore" ? /* @__PURE__ */ jsx15(LearnMore, {}) : /* @__PURE__ */ jsx15(Welcome, {}))
+          phase === "idle" && (homeScreen === "learnMore" ? /* @__PURE__ */ jsx17(LearnMore, {}) : /* @__PURE__ */ jsx17(Welcome, {}))
         ]
       }
     )
@@ -2554,6 +2820,7 @@ function writeFileTool(ctx) {
         }
         await mkdir3(dirname4(resolved2.target), { recursive: true });
         await writeFile3(resolved2.target, content, "utf8");
+        useWizard.getState().recordWrittenFile(resolved2.target);
         return `Wrote to ${filePath}`;
       } catch (err) {
         return `Error writing ${filePath}: ${err.message}`;
@@ -3334,7 +3601,7 @@ function defaultCreateModel() {
 }
 function generateRecordTool(ctx, createModel = defaultCreateModel) {
   return tool10({
-    description: "Generate realistic sample records for an entity and write them to a JSON file in the worktree. 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.",
+    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({
       entityName: z17.string().describe("Name of the entity to generate records for."),
       attributes: z17.array(z17.string()).describe("Attribute names each record must contain."),
@@ -3421,10 +3688,10 @@ import { tool as tool11 } from "ai";
 import z18 from "zod";
 function notifyUserTool() {
   return tool11({
-    description: `Give the user a brief, high-level update on what you are currently doing or about to do next. This is for the big picture (e.g. "Reading through your data models", "Writing the search UI") \u2014 not granular detail like individual tool calls, which are already logged separately. Call it when you start a new phase of work or your focus shifts, just not on every step, enough to keep the user engaged. Don't say things like "starting", just describe what you are doing. Don't mention tool calls themselves, just general direction of the work.`,
+    description: `Give the user a brief, high-level update on what you are currently doing or about to do next. This is for the big picture (e.g. "Reading through your data models", "Writing the search UI") \u2014 not granular detail like individual tool calls, which are already logged separately. Call it when you start a new phase of work or your focus shifts, just not on every step, enough to keep the user engaged. Don't say things like "starting", just describe what you are doing. Don't mention tool calls themselves, just general direction of the work. Only the latest update is shown on screen, in one line, so keep it under 140 characters.`,
     inputSchema: z18.object({
-      message: z18.string().describe(
-        "Short, plain-language description of what you are doing now."
+      message: z18.string().max(140).describe(
+        "Short, plain-language description of what you are doing now. Under 140 characters \u2014 only the latest update is shown, on one line."
       )
     }),
     execute: async ({ message }) => {
@@ -3700,7 +3967,7 @@ async function runAnalysis(mode, extraInstructions = []) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.23.0",
+  version: "0.24.0-rc.117.212",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -3762,6 +4029,7 @@ var package_default = {
     nanoid: "^5.1.15",
     pino: "^10.3.1",
     react: "^19.2.7",
+    "terminal-link": "^5.0.0",
     varlock: "^1.5.1",
     zod: "^4.4.3",
     zustand: "^5.0.14"
@@ -4067,11 +4335,10 @@ ${JSON.stringify(s.output, null, 2)}`
 function formatReviewSummary(result) {
   const nextStepLines = result.nextSteps.map((step) => {
     const isIngestCommand = step.includes(".algolia-wizard/ingest.sh");
-    const isWorktreeCommand = step.includes("/worktrees/");
     return {
       text: `\u2192 ${step}`,
-      color: isIngestCommand ? COLORS.brand : isWorktreeCommand ? COLORS.secondary : void 0,
-      bold: isIngestCommand || isWorktreeCommand
+      color: isIngestCommand ? COLORS.brand : void 0,
+      bold: isIngestCommand
     };
   });
   return [
@@ -4106,15 +4373,13 @@ ${formatCompletedSteps(ctx.completedSteps)}`,
 
 // src/actions/implement.ts
 import z29 from "zod";
-import { join as join12 } from "node:path";
+import { join as join12, relative as relative6 } from "node:path";
 
-// src/lib/worktree.ts
+// src/lib/git.ts
 import { execFile as execFile2 } from "node:child_process";
-import { copyFile, mkdir as mkdir6, readdir as readdir3, readFile as readFile8, stat as stat3, writeFile as writeFile7 } from "node:fs/promises";
+import { copyFile, mkdir as mkdir6, readFile as readFile8, stat as stat3, writeFile as writeFile7 } from "node:fs/promises";
 import { basename as basename2, dirname as dirname7, isAbsolute as isAbsolute2, join as join10, resolve as resolve3 } from "node:path";
 var MAX_BUFFER = 32 * 1024 * 1024;
-var MAX_WIZARD_WORKTREES = 3;
-var WIZARD_BRANCH_PREFIX = "wizard/implement-";
 function git(args) {
   return new Promise((resolve4, reject) => {
     execFile2("git", args, { maxBuffer: MAX_BUFFER }, (err, stdout, stderr) => {
@@ -4137,44 +4402,7 @@ async function assertGitRepoWithHead(repoRoot) {
     );
   }
 }
-async function isWorkingTreeDirty(repoRoot) {
-  const out = await git(["-C", repoRoot, "status", "--porcelain"]);
-  return out.trim().length > 0;
-}
-async function pruneOldWorktrees(repoRoot) {
-  const dir = join10(stateDir(repoRoot), "worktrees");
-  const stale = (await readdir3(dir).catch(() => [])).filter((name) => /^wizard-implement-\d+$/.test(name)).sort().reverse().slice(MAX_WIZARD_WORKTREES - 1);
-  for (const slug of stale) {
-    const branch = slug.replace("wizard-implement-", WIZARD_BRANCH_PREFIX);
-    try {
-      await git([
-        "-C",
-        repoRoot,
-        "worktree",
-        "remove",
-        "--force",
-        join10(dir, slug)
-      ]);
-      await git(["-C", repoRoot, "branch", "-D", branch]);
-    } catch (err) {
-      logger.warn(
-        { branch, err: err.message },
-        "createWorktree: failed to prune a stale wizard worktree; continuing"
-      );
-    }
-  }
-}
-async function createWorktree(repoRoot) {
-  const branch = `${WIZARD_BRANCH_PREFIX}${Date.now()}`;
-  const dirSlug = branch.replace(/\//g, "-");
-  const path = join10(stateDir(repoRoot), "worktrees", dirSlug);
-  await git(["-C", repoRoot, "worktree", "prune"]);
-  await pruneOldWorktrees(repoRoot);
-  await mkdir6(dirname7(path), { recursive: true });
-  await git(["-C", repoRoot, "worktree", "add", "-b", branch, path, "HEAD"]);
-  return { path, branch };
-}
-async function copyUploadIntoWorktree(repoRoot, worktreePath, ingestDir, sourcePath) {
+async function copyUploadIntoProject(repoRoot, ingestDir, sourcePath) {
   const trimmed = sourcePath.trim();
   if (!trimmed) {
     return { ok: false, reason: "no file path was provided" };
@@ -4188,7 +4416,10 @@ async function copyUploadIntoWorktree(repoRoot, worktreePath, ingestDir, sourceP
     return { ok: false, reason: `"${sourcePath}" does not exist` };
   }
   const relPath = join10(ingestDir, basename2(source));
-  const dest = join10(worktreePath, relPath);
+  const dest = join10(repoRoot, relPath);
+  if (resolve3(source) === resolve3(dest)) {
+    return { ok: true, relPath };
+  }
   try {
     await mkdir6(dirname7(dest), { recursive: true });
     await copyFile(source, dest);
@@ -4203,10 +4434,10 @@ async function copyUploadIntoWorktree(repoRoot, worktreePath, ingestDir, sourceP
 function hasEnvVar(content, name) {
   return new RegExp(`^(\\s*(?:export\\s+)?${name})\\s*=`, "m").test(content);
 }
-async function readEnvVar(worktreePath, name) {
+async function readEnvVar(repoRoot, name) {
   let content;
   try {
-    content = await readFile8(join10(worktreePath, ".env"), "utf8");
+    content = await readFile8(join10(repoRoot, ".env"), "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") throw err;
     return void 0;
@@ -4220,8 +4451,8 @@ async function readEnvVar(worktreePath, name) {
   if (!value || value.startsWith("<")) return void 0;
   return value;
 }
-async function writeSearchEnvValues(worktreePath, vars) {
-  const target = join10(worktreePath, ".env");
+async function writeSearchEnvValues(repoRoot, vars) {
+  const target = join10(repoRoot, ".env");
   let existing = "";
   try {
     existing = await readFile8(target, "utf8");
@@ -4236,61 +4467,27 @@ async function writeSearchEnvValues(worktreePath, vars) {
   await writeFile7(target, existing + prefix + lines, "utf8");
   return missing.map((v) => v.name);
 }
-async function listChangedFiles(worktreePath) {
-  const raw = await git(["-C", worktreePath, "status", "--porcelain", "-z"]);
-  const entries = raw.split("\0");
-  const files = [];
-  for (let i = 0; i < entries.length; i += 1) {
-    const entry = entries[i];
-    if (!entry) continue;
-    files.push(entry.slice(3));
-    if (["R", "C"].includes(entry[0]) || ["R", "C"].includes(entry[1])) i += 1;
-  }
-  return files;
-}
 function normalizeFindingPaths(findings) {
   return {
     ...findings,
     ingestionAnalysis: findings.ingestionAnalysis?.map((e) => ({
       ...e,
-      paths: e.paths.map(toWorktreeRelative)
+      paths: e.paths.map(toRootRelative)
     })),
     searchImplementationAnalysis: findings.searchImplementationAnalysis ? normalizeSearchLocation(findings.searchImplementationAnalysis) : void 0,
     confirmedEntities: findings.confirmedEntities?.map((e) => ({
       ...e,
-      paths: e.paths.map(toWorktreeRelative)
+      paths: e.paths.map(toRootRelative)
     }))
   };
 }
 function normalizeSearchLocation(path) {
-  const normalized = path ? toWorktreeRelative(path).trim() : "";
+  const normalized = path ? toRootRelative(path).trim() : "";
   return normalized && normalized.toLowerCase() !== "unknown" ? normalized : void 0;
 }
-function toWorktreeRelative(p) {
+function toRootRelative(p) {
   return p.replace(/^\/+/, "");
 }
-async function confirmDirtyWorkingTree(ctx, repoRoot) {
-  const MAX_LISTED_DIRTY_FILES = 10;
-  const dirty = await listChangedFiles(repoRoot);
-  const shown = dirty.slice(0, MAX_LISTED_DIRTY_FILES);
-  const overflow = dirty.length - shown.length;
-  const answer = await ctx.requestUserInput({
-    prompt: "Proceed using HEAD only? Uncommitted changes will NOT be included in the generated implementation.",
-    promptType: "acceptReject",
-    options: [],
-    messages: [
-      `${dirty.length} uncommitted change(s) detected. The wizard builds an isolated worktree from HEAD, so these are ignored:`,
-      ...shown.map((file) => `  \u2022 ${file}`),
-      ...overflow > 0 ? [`  \u2022 \u2026and ${overflow} more`] : [],
-      "Commit or stash them first to include them in the implementation."
-    ]
-  });
-  if (answer !== true) {
-    throw new Error(
-      "implement aborted: commit or stash your changes so they are built into the worktree, then re-run the wizard."
-    );
-  }
-}
 
 // src/lib/algoliaDocs.ts
 import { readFileSync, readdirSync, existsSync } from "node:fs";
@@ -4350,11 +4547,6 @@ function getFrameworkSpecificDoc(frameworks) {
   return loadAlgoliaDoc("js");
 }
 
-// src/lib/shell.ts
-function shellQuote(value) {
-  return "'" + value.replace(/'/g, "'\\''") + "'";
-}
-
 // src/actions/resolveEnvVarPrefix.ts
 import z28 from "zod";
 var resolveEnvVarPrefixSchema = z28.object({
@@ -4374,9 +4566,7 @@ var resolveEnvVarPrefix = (frameworkName) => runAgent({
 
 // src/actions/implement.ts
 var implementSchema = z29.object({
-  filesChanged: z29.array(z29.string()),
   summary: z29.string(),
-  worktreePath: z29.string().optional(),
   ingestCommand: z29.string().optional(),
   ingestScriptRan: z29.boolean().optional(),
   ingestRecordCount: z29.number().optional(),
@@ -4429,8 +4619,6 @@ function frameworksForDoc(language) {
 }
 function baseInstructions(input) {
   return [
-    // Agents have renamed this (e.g. appending the project name), which the
-    // index-scoped keys then reject with a 403.
     `Target Algolia index, to be used exactly as written \u2014 never renamed, re-cased, prefixed, or suffixed: "${input.targetIndex}"`,
     `Project languages and frameworks: ${JSON.stringify(input.language)}`,
     "Make minimal, idiomatic changes; do not touch unrelated code.",
@@ -4448,14 +4636,14 @@ function sourceSpecificInstructions(input) {
       "Add env vars for any local source access (DB URL, API base, file paths) that is not a fixed repo path."
     ],
     fileUpload: [
-      `Records come from the developer's file, already copied into the worktree at "${input.uploadFilePath}". Read and parse that exact file.`,
+      `Records come from the developer's file, already copied into the project at "${input.uploadFilePath}". Read and parse that exact file.`,
       "Parse by extension: JSON = array of objects; CSV/TSV = header row maps to keys.",
       "Map parsed columns/fields to the confirmed entity attributes.",
       "Never fabricate, hardcode, or substitute a different file."
     ],
     generated: [
       "No real data source exists; use sample records for each confirmed entity.",
-      "Call the generateRecord tool once per entity (entityName, attributes, count 20-50); it invents the values and unique objectIDs and writes them to a JSON file in the worktree, returning the file path. Do not write records or objectIDs yourself.",
+      "Call the generateRecord tool once per entity (entityName, attributes, count 20-50); it invents the values and unique objectIDs and writes them to a JSON file, returning the file path. Do not write records or objectIDs yourself.",
       "In the script, read and parse each returned file path at runtime using your language's standard JSON support, instead of inlining the records as literals.",
       "Add a prominent TODO where the developer swaps the generated records (and the JSON file under `.algolia-wizard/data/`) for their real record source."
     ]
@@ -4504,14 +4692,11 @@ function searchInstructions(input) {
     "If a search box already exists, replace it with yours.",
     `Read the index name from the ${publicIndexNameVar(input.publicEnvVarPrefix)} env var, which the wizard sets to "${input.targetIndex}". Never hardcode an index name or derive one from the project, file, or component name.`,
     "Read the App ID, the search-only API key, and the index name from env vars; never hardcode them. A search-only key is safe to expose client-side.",
-    // The key is provisioned only after verification passes, so the agent never
-    // sees one. It must also leave .env alone: the wizard reads that file to
-    // decide whether a key already exists, and an agent-invented value there
-    // would be reused as if it were real.
+    // The key is provisioned only after verification passes, and the wizard
+    // reads .env to decide whether a key already exists — an agent-invented
+    // value there would be reused as if it were real.
     `Add Algolia App ID "${input.appId}"; leave the search-only key as a placeholder. Do not create or edit .env \u2014 the wizard writes the resolved key there itself.`,
-    // Not the agent's to rename: the wizard writes these exact names into
-    // ".env" right after this step, so a renamed prefix would leave the code
-    // reading a var the wizard never wrote.
+    // The wizard writes these exact names into .env right after this step.
     `Use exactly these env var names in the code: ${input.searchEnvVars.map(({ name }) => name).join(", ")}.`,
     "Install any Algolia packages you import with the project's own package manager via runShell, and declare them in the project's dependency manifest.",
     "Match the styles of the application as closely as possible.",
@@ -4520,10 +4705,10 @@ function searchInstructions(input) {
 }
 function verificationInstructions(input) {
   return [
-    "Verify the Algolia implementation changes in the current worktree.",
+    "Verify the Algolia implementation changes.",
     `Verification tools found in the codebase: ${JSON.stringify(input.findings.verification ?? [])}.`,
     "Run the project's own checks (lint, type check, tests) via runShell, using the commands the project actually defines \u2014 its task runner, manifest scripts, or Makefile. Run every check that applies, not just the first.",
-    "This worktree starts with no installed dependencies. If a check fails because packages or modules are missing, install the dependencies via runShell and re-run it rather than changing the code.",
+    "If a check fails because packages or modules are missing, install the dependencies via runShell and re-run it rather than changing the code.",
     "For issues caused by the implementation, make minimal fixes with writeFile and re-run the checks.",
     "Do not make speculative fixes when no checks exist, a check cannot run, or failures are unrelated to these changes \u2014 note the limitation in your summary.",
     "Do not add new Algolia functionality here; only validate and make minimal correctness fixes.",
@@ -4618,11 +4803,11 @@ function ingestFailure(attempt, executions) {
   }
   return { reason: `it failed (exit ${attempt.exitCode ?? "unknown"})`, detail };
 }
-function makeToolContext(worktree, env = async () => ({})) {
+function makeToolContext(root, env = async () => ({})) {
   return createToolContext(
     DEFAULT_TOOL_LIMITS,
-    worktree,
-    createShellContext({ env, approve: storeApproval(worktree) })
+    root,
+    createShellContext({ env, approve: storeApproval(root) })
   );
 }
 function verificationRetryInstructions(verification) {
@@ -4630,7 +4815,7 @@ function verificationRetryInstructions(verification) {
     `Implementation insufficient. Address these findings before reporting completion: ${verification.additionalInstructions ?? verification.summary}`
   ];
 }
-async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES, existingWorktreePath) {
+async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
   const repoRoot = process.cwd();
   const scan = ctx.getStepOutput("project-scan");
   const entities = ctx.getStepOutput(
@@ -4711,9 +4896,6 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES, existingWo
   const targetIndex = selected?.selection;
   useWizard.getState().setTargetIndex(targetIndex ?? null);
   await assertGitRepoWithHead(repoRoot);
-  if (await isWorkingTreeDirty(repoRoot)) {
-    await confirmDirtyWorkingTree(ctx, repoRoot);
-  }
   const normalized = normalizeFindingPaths(findings);
   const confirmed2 = normalized.confirmedEntities;
   const searchLocation = normalized.searchImplementationAnalysis;
@@ -4725,328 +4907,303 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES, existingWo
   if (useCases.includes("ingestion")) {
     ingestAppId = appId ?? (await requireApplication()).id;
   }
-  const worktree = existingWorktreePath ?? (await createWorktree(repoRoot)).path;
-  try {
-    process.chdir(worktree);
-    let uploadFilePath;
-    let uploadWarning;
-    if (ingestionSource === "fileUpload") {
-      const copied = await copyUploadIntoWorktree(
+  let uploadFilePath;
+  let uploadWarning;
+  if (ingestionSource === "fileUpload") {
+    const copied = await copyUploadIntoProject(
+      repoRoot,
+      INGEST_DIR,
+      uploadSourcePath ?? ""
+    );
+    if (copied.ok) {
+      uploadFilePath = copied.relPath;
+    } else {
+      ingestionSource = "generated";
+      uploadWarning = `\u26A0\uFE0F Could not use the uploaded file (${copied.reason}); generating sample records instead.`;
+      logger.warn(
+        { reason: copied.reason },
+        "implement: file upload unavailable; falling back to generated sample records"
+      );
+    }
+  }
+  const publicEnvVarPrefix = await publicEnvVarPrefixPromise;
+  const input = {
+    findings: normalized,
+    confirmed: confirmed2,
+    searchLocation,
+    targetIndex,
+    language,
+    publicEnvVarPrefix,
+    appId,
+    searchEnvVars: publicSearchEnvVars(publicEnvVarPrefix, targetIndex, appId),
+    ingestDir: INGEST_DIR,
+    ingestionSource,
+    uploadFilePath,
+    searchUiTarget: searchUiTarget(language)
+  };
+  const summaries = [];
+  if (uploadWarning) summaries.push(uploadWarning);
+  let envSearchKey;
+  let envAppIdMismatch = false;
+  if (useCases.includes("search") && appId) {
+    const envAppId = await readEnvVar(
+      repoRoot,
+      publicAppIdVar(publicEnvVarPrefix)
+    );
+    if (envAppId === appId) {
+      envSearchKey = await readEnvVar(
         repoRoot,
-        worktree,
-        INGEST_DIR,
-        uploadSourcePath ?? ""
+        publicSearchKeyVar(publicEnvVarPrefix)
+      );
+    } else if (envAppId) {
+      envAppIdMismatch = true;
+      const appIdVarName = publicAppIdVar(publicEnvVarPrefix);
+      const searchKeyVarName = publicSearchKeyVar(publicEnvVarPrefix);
+      summaries.push(
+        `\u26A0\uFE0F .env already sets ${appIdVarName}=${envAppId}, but the active Algolia application is ${appId}. The wizard left those values alone \u2014 update ${appIdVarName} and ${searchKeyVarName} by hand, or searches will fail.`
+      );
+      logger.warn(
+        { envAppId, appId },
+        "implement: .env holds credentials for a different Algolia application; not reusing its search key"
       );
-      if (copied.ok) {
-        uploadFilePath = copied.relPath;
-      } else {
-        ingestionSource = "generated";
-        uploadWarning = `\u26A0\uFE0F Could not use the uploaded file (${copied.reason}); generating sample records instead.`;
-        logger.warn(
-          { reason: copied.reason },
-          "implement: file upload unavailable; falling back to generated sample records"
-        );
-      }
     }
-    const publicEnvVarPrefix = await publicEnvVarPrefixPromise;
-    const input = {
-      findings: normalized,
-      confirmed: confirmed2,
-      searchLocation,
-      targetIndex,
-      language,
-      publicEnvVarPrefix,
-      appId,
-      searchEnvVars: publicSearchEnvVars(
-        publicEnvVarPrefix,
-        targetIndex,
-        appId
+  }
+  let finalSearchEnvVars = input.searchEnvVars;
+  let agentRuns = 0;
+  let ingestCommand;
+  let ingestScriptRan = false;
+  let ingestRecordCount;
+  let ingestDurationMs;
+  let ingestOutcomeMessage;
+  const ingestKeyAppId = ingestAppId;
+  const ingestionTools = ingestKeyAppId ? makeToolContext(repoRoot, async () => ({
+    [APP_ID_VAR]: ingestKeyAppId,
+    [API_KEY_VAR]: (await resolveWriteKey(targetIndex, ingestKeyAppId)).key,
+    [INDEX_NAME_VAR]: targetIndex
+  })) : void 0;
+  const searchTools = makeToolContext(repoRoot);
+  async function runImplementationUseCase(currentUseCase, extraInstructions = []) {
+    if (agentRuns > 0) ctx.recordStepExecution();
+    agentRuns += 1;
+    return runAgent({
+      instructions: buildAgentInstructions(
+        currentUseCase,
+        input,
+        extraInstructions
       ),
-      ingestDir: INGEST_DIR,
-      ingestionSource,
-      uploadFilePath,
-      searchUiTarget: searchUiTarget(language)
-    };
-    const summaries = [];
-    if (uploadWarning) summaries.push(uploadWarning);
-    let envSearchKey;
-    let envAppIdMismatch = false;
-    if (useCases.includes("search") && appId) {
-      const envAppId = await readEnvVar(
-        worktree,
-        publicAppIdVar(publicEnvVarPrefix)
+      tools: toolsForUseCase(currentUseCase, input.ingestionSource),
+      outputSchema: implementationOutputSchema,
+      toolContext: currentUseCase === "ingestion" ? ingestionTools ?? searchTools : searchTools
+    });
+  }
+  async function runVerificationUseCase() {
+    if (agentRuns > 0) ctx.recordStepExecution();
+    agentRuns += 1;
+    return runAgent({
+      instructions: buildAgentInstructions("verification", input),
+      tools: toolsForUseCase("verification"),
+      outputSchema: verificationOutputSchema,
+      toolContext: searchTools
+    });
+  }
+  if (useCases.includes("ingestion")) {
+    let ingestFailureDetail;
+    const result = await runImplementationUseCase("ingestion");
+    summaries.push(formatSummary("ingestion", result.summary));
+    ingestCommand = result.ingestCommand;
+    const ingestionContext = ingestionTools ?? searchTools;
+    const executions = ingestionContext.shell.executions;
+    const {
+      run: ingestRun,
+      attempt: ingestAttempt,
+      recordCount
+    } = ingestOutcome(executions, ingestCommand);
+    ingestScriptRan = ingestRun != null;
+    ingestRecordCount = recordCount;
+    ingestDurationMs = ingestRun?.durationMs;
+    if (ingestScriptRan && ingestionContext.reviewed.length === 0) {
+      summaries.push(
+        "\u26A0\uFE0F The ingestion script ran without being shown to you for review. Read it in your project before trusting the index contents."
+      );
+      logger.warn(
+        { ingestCommand },
+        "implement: ingestion ran without a reviewScript call"
       );
-      if (envAppId === appId) {
-        envSearchKey = await readEnvVar(
-          worktree,
-          publicSearchKeyVar(publicEnvVarPrefix)
-        );
-      } else if (envAppId) {
-        envAppIdMismatch = true;
-        const appIdVarName = publicAppIdVar(publicEnvVarPrefix);
-        const searchKeyVarName = publicSearchKeyVar(publicEnvVarPrefix);
-        summaries.push(
-          `\u26A0\uFE0F .env already sets ${appIdVarName}=${envAppId}, but the active Algolia application is ${appId}. The wizard left those values alone \u2014 update ${appIdVarName} and ${searchKeyVarName} by hand, or searches will fail.`
-        );
-        logger.warn(
-          { envAppId, appId },
-          "implement: .env holds credentials for a different Algolia application; not reusing its search key"
-        );
-      }
-    }
-    let finalSearchEnvVars = input.searchEnvVars;
-    let agentRuns = 0;
-    let ingestCommand;
-    let ingestScriptRan = false;
-    let ingestRecordCount;
-    let ingestDurationMs;
-    let ingestOutcomeMessage;
-    const ingestKeyAppId = ingestAppId;
-    const ingestionTools = ingestKeyAppId ? makeToolContext(worktree, async () => ({
-      [APP_ID_VAR]: ingestKeyAppId,
-      [API_KEY_VAR]: (await resolveWriteKey(targetIndex, ingestKeyAppId)).key,
-      [INDEX_NAME_VAR]: targetIndex
-    })) : void 0;
-    const searchTools = makeToolContext(worktree);
-    async function runImplementationUseCase(currentUseCase, extraInstructions = []) {
-      if (agentRuns > 0) ctx.recordStepExecution();
-      agentRuns += 1;
-      return runAgent({
-        instructions: buildAgentInstructions(
-          currentUseCase,
-          input,
-          extraInstructions
-        ),
-        tools: toolsForUseCase(currentUseCase, input.ingestionSource),
-        outputSchema: implementationOutputSchema,
-        toolContext: currentUseCase === "ingestion" ? ingestionTools ?? searchTools : searchTools
-      });
-    }
-    async function runVerificationUseCase() {
-      if (agentRuns > 0) ctx.recordStepExecution();
-      agentRuns += 1;
-      return runAgent({
-        instructions: buildAgentInstructions("verification", input),
-        tools: toolsForUseCase("verification"),
-        outputSchema: verificationOutputSchema,
-        toolContext: searchTools
-      });
     }
-    if (useCases.includes("ingestion")) {
-      let ingestFailureDetail;
-      const result = await runImplementationUseCase("ingestion");
-      summaries.push(formatSummary("ingestion", result.summary));
-      ingestCommand = result.ingestCommand;
-      const ingestionContext = ingestionTools ?? searchTools;
-      const executions = ingestionContext.shell.executions;
-      const {
-        run: ingestRun,
-        attempt: ingestAttempt,
-        recordCount
-      } = ingestOutcome(executions, ingestCommand);
-      ingestScriptRan = ingestRun != null;
-      ingestRecordCount = recordCount;
-      ingestDurationMs = ingestRun?.durationMs;
-      if (ingestScriptRan && ingestionContext.reviewed.length === 0) {
-        summaries.push(
-          "\u26A0\uFE0F The ingestion script ran without being shown to you for review. Read it in the worktree before trusting the index contents."
-        );
-        logger.warn(
-          { ingestCommand },
-          "implement: ingestion ran without a reviewScript call"
-        );
+    if (ingestScriptRan) {
+      ingestOutcomeMessage = `\u2705 Ingestion succeeded${ingestRecordCount != null ? ` \u2014 ${ingestRecordCount} record(s) indexed.` : "."}`;
+      if (ingestRecordCount != null) {
+        track("AI Wizard Ingest Successful", {
+          entity_name: confirmed2?.map((e) => e.name).join(", ") || "unknown",
+          record_count: ingestRecordCount,
+          duration_ms: ingestDurationMs ?? 0
+        });
       }
-      if (ingestScriptRan) {
-        ingestOutcomeMessage = `\u2705 Ingestion succeeded${ingestRecordCount != null ? ` \u2014 ${ingestRecordCount} record(s) indexed.` : "."}`;
-        if (ingestRecordCount != null) {
-          track("AI Wizard Ingest Successful", {
-            entity_name: confirmed2?.map((e) => e.name).join(", ") || "unknown",
-            record_count: ingestRecordCount,
-            duration_ms: ingestDurationMs ?? 0
-          });
-        }
-      } else {
-        const { reason, detail } = ingestFailure(ingestAttempt, executions);
-        ingestOutcomeMessage = `\u26A0\uFE0F Records were not indexed \u2014 ${reason}.${ingestCommand ? " Run the command below when you are ready." : ""}`;
-        ingestFailureDetail = detail;
-        summaries.push(
-          `\u26A0\uFE0F Ingestion did not complete: ${reason}.${detail ? `
+    } else {
+      const { reason, detail } = ingestFailure(ingestAttempt, executions);
+      ingestOutcomeMessage = `\u26A0\uFE0F Records were not indexed \u2014 ${reason}.${ingestCommand ? " Run the command below when you are ready." : ""}`;
+      ingestFailureDetail = detail;
+      summaries.push(
+        `\u26A0\uFE0F Ingestion did not complete: ${reason}.${detail ? `
 ${detail}` : ""}`
-        );
-        logger.warn(
+      );
+      logger.warn(
+        {
+          ingestCommand,
+          reason,
+          approved: ingestAttempt?.approved,
+          exitCode: ingestAttempt?.exitCode,
+          timedOut: ingestAttempt?.timedOut,
+          commandsRun: executions.length
+        },
+        "implement: ingestion script did not complete successfully"
+      );
+      track("Error", {
+        step: "Push Data",
+        error: `ingestion did not complete: ${reason}`,
+        product_area: "AI Wizard"
+      });
+    }
+    const commandMessages = ingestCommand ? [`Ingestion command: ${ingestCommand}`] : [];
+    await ctx.requestUserInput({
+      prompt: "",
+      promptType: "enterToContinue",
+      options: [],
+      // One message per line: Notices.tsx counts a message as one wrapped
+      // line, so an embedded newline overflows the panel's height accounting.
+      messages: [
+        ingestOutcomeMessage,
+        ...ingestFailureDetail?.split("\n").filter((l) => l.trim()) ?? [],
+        ...commandMessages
+      ]
+    });
+  }
+  if (useCases.includes("search")) {
+    let extraInstructions = [];
+    useWizard.getState().clearWrittenFiles();
+    for (let attempt = 1; attempt <= MAX_IMPLEMENT_VERIFICATION_ATTEMPTS; attempt++) {
+      if (attempt > 1) {
+        logger.info(
           {
-            ingestCommand,
-            reason,
-            approved: ingestAttempt?.approved,
-            exitCode: ingestAttempt?.exitCode,
-            timedOut: ingestAttempt?.timedOut,
-            commandsRun: executions.length
+            attempt,
+            maxAttempts: MAX_IMPLEMENT_VERIFICATION_ATTEMPTS,
+            extraInstructions
           },
-          "implement: ingestion script did not complete successfully"
+          "implement: retrying search implementation after failed verification"
         );
-        track("Error", {
-          step: "Push Data",
-          error: `ingestion did not complete: ${reason}`,
-          product_area: "AI Wizard"
+      }
+      const { summary } = await runImplementationUseCase(
+        "search",
+        extraInstructions
+      );
+      summaries.push(formatSummary("search", summary));
+      const verification = await runVerificationUseCase();
+      summaries.push(formatSummary("verification", verification.summary));
+      if (verification.sufficient) {
+        ctx.setUserInput("implementation", "success");
+        const searchFilesChanged = [
+          ...new Set(useWizard.getState().writtenFiles)
+        ].map((file) => relative6(repoRoot, file));
+        track("AI Wizard Frontend Component Generated", {
+          filePaths: searchFilesChanged
         });
+        track("AI Wizard Wired to UI", {
+          location_heuristic: searchLocation ?? "unknown"
+        });
+        break;
       }
-      const commandMessages = [`Open the worktree: cd ${shellQuote(worktree)}`];
-      if (ingestCommand) {
-        commandMessages.push(`Ingestion command: ${ingestCommand}`);
+      if (attempt === MAX_IMPLEMENT_VERIFICATION_ATTEMPTS) {
+        ctx.setUserInput("implementation", "fail");
+        throw new Error(
+          `Implementation verification failed after ${MAX_IMPLEMENT_VERIFICATION_ATTEMPTS} attempts: ${verification.additionalInstructions ?? verification.summary}`
+        );
       }
-      await ctx.requestUserInput({
-        prompt: "",
-        promptType: "enterToContinue",
-        options: [],
-        // The wizard never streams command output, so a failed run's tail is the
-        // only place the developer sees why it failed. One message per line:
-        // the panel's height accounting counts a message as one wrapped line
-        // (see Notices.tsx), so an embedded newline overflows it.
-        messages: [
-          ingestOutcomeMessage,
-          ...ingestFailureDetail?.split("\n").filter((l) => l.trim()) ?? [],
-          ...commandMessages
-        ]
-      });
+      extraInstructions = verificationRetryInstructions(verification);
     }
-    if (useCases.includes("search")) {
-      let extraInstructions = [];
-      const preSearchFiles = new Set(await listChangedFiles(worktree));
-      for (let attempt = 1; attempt <= MAX_IMPLEMENT_VERIFICATION_ATTEMPTS; attempt++) {
-        if (attempt > 1) {
-          logger.info(
-            {
-              attempt,
-              maxAttempts: MAX_IMPLEMENT_VERIFICATION_ATTEMPTS,
-              extraInstructions
-            },
-            "implement: retrying search implementation after failed verification"
-          );
-        }
-        const { summary } = await runImplementationUseCase(
-          "search",
-          extraInstructions
+    let searchKey;
+    let searchKeyError;
+    if (appId) {
+      try {
+        const resolved2 = await resolveSearchOnlyKey(
+          targetIndex,
+          appId,
+          envSearchKey
+        );
+        searchKey = resolved2.key;
+        summaries.push(
+          resolved2.source === "created" ? `Created a new search-only Algolia API key for the "${targetIndex}" index in app ${appId} \u2014 safe to expose in frontend code.` : `Reused the existing search-only Algolia API key for the "${targetIndex}" index in app ${appId}.`
+        );
+      } catch (err) {
+        searchKeyError = err.message;
+        logger.warn(
+          { err: searchKeyError },
+          "implement: could not provision a search-only API key; the .env value stays a placeholder"
         );
-        summaries.push(formatSummary("search", summary));
-        const verification = await runVerificationUseCase();
-        summaries.push(formatSummary("verification", verification.summary));
-        if (verification.sufficient) {
-          ctx.setUserInput("implementation", "success");
-          const searchFilesChanged = (await listChangedFiles(worktree)).filter(
-            (file) => !preSearchFiles.has(file)
-          );
-          track("AI Wizard Frontend Component Generated", {
-            filePaths: searchFilesChanged
-          });
-          track("AI Wizard Wired to UI", {
-            location_heuristic: searchLocation ?? "unknown"
-          });
-          break;
-        }
-        if (attempt === MAX_IMPLEMENT_VERIFICATION_ATTEMPTS) {
-          ctx.setUserInput("implementation", "fail");
-          throw new Error(
-            `Implementation verification failed after ${MAX_IMPLEMENT_VERIFICATION_ATTEMPTS} attempts: ${verification.additionalInstructions ?? verification.summary}`
-          );
-        }
-        extraInstructions = verificationRetryInstructions(verification);
-      }
-      let searchKey;
-      let searchKeyError;
-      if (appId) {
-        try {
-          const resolved2 = await resolveSearchOnlyKey(
-            targetIndex,
-            appId,
-            envSearchKey
-          );
-          searchKey = resolved2.key;
-          summaries.push(
-            resolved2.source === "created" ? `Created a new search-only Algolia API key for the "${targetIndex}" index in app ${appId} \u2014 safe to expose in frontend code.` : `Reused the existing search-only Algolia API key for the "${targetIndex}" index in app ${appId}.`
-          );
-        } catch (err) {
-          searchKeyError = err.message;
-          logger.warn(
-            { err: searchKeyError },
-            "implement: could not provision a search-only API key; the .env value stays a placeholder"
-          );
-        }
       }
-      finalSearchEnvVars = publicSearchEnvVars(
-        publicEnvVarPrefix,
-        targetIndex,
-        appId,
-        searchKey
-      );
-      const resolvedSearchEnvVars = finalSearchEnvVars.filter(
-        (v) => !v.value.startsWith("<")
+    }
+    finalSearchEnvVars = publicSearchEnvVars(
+      publicEnvVarPrefix,
+      targetIndex,
+      appId,
+      searchKey
+    );
+    const resolvedSearchEnvVars = finalSearchEnvVars.filter(
+      (v) => !v.value.startsWith("<")
+    );
+    if (resolvedSearchEnvVars.length > 0) {
+      const written = await writeSearchEnvValues(
+        repoRoot,
+        resolvedSearchEnvVars
       );
-      if (resolvedSearchEnvVars.length > 0) {
-        const written = await writeSearchEnvValues(
-          worktree,
-          resolvedSearchEnvVars
+      if (written.length > 0) {
+        summaries.push(`Wrote ${written.join(", ")} to .env.`);
+      }
+      const ignored = await ensureGitIgnored(repoRoot, join12(repoRoot, ".env"));
+      if (ignored === "added") {
+        summaries.push("Added .env to .gitignore.");
+      } else if (ignored === "tracked") {
+        summaries.push(
+          '\u26A0\uFE0F .env is tracked by git, so a .gitignore rule cannot un-stage it. Run "git rm --cached .env" before committing, or the credentials go into history.'
         );
-        if (written.length > 0) {
-          summaries.push(`Wrote ${written.join(", ")} to .env.`);
-        }
-        const ignored = await ensureGitIgnored(worktree, join12(worktree, ".env"));
-        if (ignored === "added") {
-          summaries.push("Added .env to .gitignore.");
-        } else if (ignored === "tracked") {
-          summaries.push(
-            '\u26A0\uFE0F .env is tracked by git, so a .gitignore rule cannot un-stage it. Run "git rm --cached .env" before committing, or the credentials go into history.'
-          );
-        }
-        const stale = [];
-        for (const v of resolvedSearchEnvVars) {
-          if (written.includes(v.name)) continue;
-          const current = await readEnvVar(worktree, v.name);
-          if (current && current !== v.value) stale.push(v);
-        }
-        if (stale.length > 0 && !envAppIdMismatch) {
-          summaries.push(
-            `\u26A0\uFE0F .env already assigns a different value to ${stale.map((v) => `${v.name} (should be ${v.value})`).join(", ")} \u2014 the wizard left it alone. Fix it by hand, or searches will fail.`
-          );
-          logger.warn(
-            { vars: stale.map((v) => v.name) },
-            "implement: .env holds different values for the resolved search credentials; not overwriting them"
-          );
-        }
       }
-      const unresolvedSearchEnvVars = finalSearchEnvVars.filter(
-        (v) => v.value.startsWith("<")
-      );
-      if (unresolvedSearchEnvVars.length > 0) {
+      const stale = [];
+      for (const v of resolvedSearchEnvVars) {
+        if (written.includes(v.name)) continue;
+        const current = await readEnvVar(repoRoot, v.name);
+        if (current && current !== v.value) stale.push(v);
+      }
+      if (stale.length > 0 && !envAppIdMismatch) {
         summaries.push(
-          `Could not resolve a value for ${unresolvedSearchEnvVars.map((v) => v.name).join(", ")} \u2014 fill it in manually in .env.` + // Without the reason the line is a dead end.
-          (searchKeyError ? ` Reason: ${searchKeyError}` : "")
+          `\u26A0\uFE0F .env already assigns a different value to ${stale.map((v) => `${v.name} (should be ${v.value})`).join(", ")} \u2014 the wizard left it alone. Fix it by hand, or searches will fail.`
+        );
+        logger.warn(
+          { vars: stale.map((v) => v.name) },
+          "implement: .env holds different values for the resolved search credentials; not overwriting them"
         );
       }
-    } else {
-      ctx.setUserInput("implementation", "success");
     }
-    const filesChanged = await listChangedFiles(worktree);
-    if (filesChanged.length === 0) {
-      logger.warn(
-        "implement: agent reported success but no files changed in the worktree"
+    const unresolvedSearchEnvVars = finalSearchEnvVars.filter(
+      (v) => v.value.startsWith("<")
+    );
+    if (unresolvedSearchEnvVars.length > 0) {
+      summaries.push(
+        `Could not resolve a value for ${unresolvedSearchEnvVars.map((v) => v.name).join(", ")} \u2014 fill it in manually in .env.` + (searchKeyError ? ` Reason: ${searchKeyError}` : "")
       );
     }
-    return {
-      ingestionSource,
-      filesChanged,
-      summary: summaries.join("\n\n"),
-      worktreePath: worktree,
-      ...useCases.includes("ingestion") && ingestCommand ? {
-        ingestCommand,
-        ingestScriptRan,
-        ...ingestRecordCount != null ? { ingestRecordCount } : {},
-        ...ingestDurationMs != null ? { ingestDurationMs } : {}
-      } : {},
-      ...useCases.includes("search") ? { searchEnvVars: finalSearchEnvVars } : {}
-    };
-  } finally {
-    process.chdir(repoRoot);
+  } else {
+    ctx.setUserInput("implementation", "success");
   }
+  return {
+    ingestionSource,
+    summary: summaries.join("\n\n"),
+    ...useCases.includes("ingestion") && ingestCommand ? {
+      ingestCommand,
+      ingestScriptRan,
+      ...ingestRecordCount != null ? { ingestRecordCount } : {},
+      ...ingestDurationMs != null ? { ingestDurationMs } : {}
+    } : {},
+    ...useCases.includes("search") ? { searchEnvVars: finalSearchEnvVars } : {}
+  };
 }
 
 // src/workflows/default.ts
@@ -5118,10 +5275,7 @@ var defaultWorkflow = {
         ctx.notify({
           messages: ["Building your Algolia search experience\u2026"]
         });
-        const ingestion2 = ctx.getStepOutput(
-          "ingestion"
-        );
-        return implement(ctx, ["search"], ingestion2?.worktreePath);
+        return implement(ctx, ["search"]);
       }
     }),
     defineStep({
@@ -5136,9 +5290,8 @@ var defaultWorkflow = {
           "ingestion"
         );
         return reviewStep(ctx, {
-          // The ingestion step already showed the user the exact `ingestCommand`
-          // and worktree path as a notice, so nextSteps must not restate it —
-          // an LLM-paraphrased command risks being wrong.
+          // ingestCommand was already shown verbatim as a notice; an
+          // LLM-paraphrased restatement in nextSteps risks being wrong.
           nextStepsGuidance: ingestion2?.ingestScriptRan ? "The wizard already ran the ingestion script and records are in the index. Do NOT tell the user to run it again; instead point them at the target index to confirm the records. Do not restate the ingestion command \u2014 the wizard already showed it to them." : "Tell the user to run the ingestion script; do not restate the exact command \u2014 the wizard already showed it to them above."
         });
       }
@@ -5185,7 +5338,6 @@ var selectIndex = {
   selection: "wizard_seed_products"
 };
 var ingestion = {
-  filesChanged: ["algolia/ingest.mjs", "algolia/records.json", "package.json"],
   summary: "Generated sample Product records and an ingestion script that pushes them to the target index with algoliasearch.",
   ingestCommand: "node algolia/ingest.mjs",
   ingestScriptRan: true,
@@ -5197,7 +5349,6 @@ var confirmFramework2 = {
   frameworks: projectScan2.frameworks
 };
 var search = {
-  filesChanged: ["src/components/Search.tsx", "src/components/Header.tsx", ".env"],
   summary: "Added an InstantSearch-powered search box and results list, mounted in the shared header component.",
   ingestionSource: "generated",
   searchEnvVars: [
@@ -5210,7 +5361,7 @@ var review = {
     "Ingested 25 generated Product records into wizard_seed_products.",
     "Added an InstantSearch search experience to the shared header."
   ],
-  reviewPrompt: "Review the Algolia ingestion and search changes in this worktree.",
+  reviewPrompt: "Review the Algolia ingestion and search changes.",
   nextSteps: ["Point the ingestion script at your real product data."]
 };
 var SEEDS = {
@@ -5327,9 +5478,9 @@ Options:
                    steps pre-filled with test data. Pass with no value to print
                    the step ids. See CONTRIBUTING.md.
   --no-telemetry   Send no telemetry or analytics for this run.
-  --reset-on-run   Wipe this project's wizard state (run state, AI consent,
-                   worktrees) before starting, so the run behaves like a
-                   first-ever run. Also drops every API key the wizard has
+  --reset-on-run   Wipe this project's wizard state (run state, AI consent)
+                   before starting, so the run behaves like a first-ever
+                   run. Also drops every API key the wizard has
                    stored in your keychain (or, where the platform has none,
                    the encrypted file it falls back to \u2014 see CONTRIBUTING.md),
                    for this project and any other, so later runs create new
@@ -5369,7 +5520,7 @@ function parseCliArgs(argv) {
 }
 
 // src/lib/resetState.ts
-import { readdir as readdir4, rm as rm2 } from "node:fs/promises";
+import { readdir as readdir3, rm as rm2 } from "node:fs/promises";
 import { join as join13 } from "node:path";
 var KEEP = ["wizard.log"];
 async function resetProjectState() {
@@ -5377,7 +5528,7 @@ async function resetProjectState() {
   await forgetResolvedKeys();
   let entries;
   try {
-    entries = await readdir4(dir);
+    entries = await readdir3(dir);
   } catch {
     return { dir, removed: [] };
   }
@@ -5430,7 +5581,7 @@ function delay(ms) {
 }
 
 // src/main.tsx
-import { jsx as jsx16 } from "react/jsx-runtime";
+import { jsx as jsx18 } from "react/jsx-runtime";
 async function startup() {
   setProjectRoot(process.cwd());
   let args;
@@ -5480,7 +5631,7 @@ ${formatStepList(workflow)}`);
 }
 async function run(workflow) {
   const store = useWizard.getState();
-  const instance = render(/* @__PURE__ */ jsx16(App, {}), { incrementalRendering: true });
+  const instance = render(/* @__PURE__ */ jsx18(App, {}), { incrementalRendering: true });
   await store.waitForStart();
   let user = await getUser();
   if (!user) {