@algolia/wizard 0.12.0-rc.104.151 → 0.12.0

package/dist/main.js

@@ -4,7 +4,7 @@
 import { render } from "ink";
 
 // src/ui/App.tsx
-import { Box as Box15, Text as Text15, useApp, useInput as useInput6, useWindowSize as useWindowSize8 } from "ink";
+import { Box as Box16, Text as Text16, useApp, useInput as useInput7, useWindowSize as useWindowSize8 } from "ink";
 
 // src/core/store.ts
 import { create } from "zustand";
@@ -304,7 +304,10 @@ var useWizard = create((set, get) => ({
     if (_noticeTimer === null) {
       set({
         notices: [...notices, notice],
-        _noticeTimer: setTimeout(() => get()._drainNoticeQueue(), NOTICE_INTERVAL_MS)
+        _noticeTimer: setTimeout(
+          () => get()._drainNoticeQueue(),
+          NOTICE_INTERVAL_MS
+        )
       });
     } else {
       set({ _noticeQueue: [..._noticeQueue, notice] });
@@ -316,7 +319,10 @@ var useWizard = create((set, get) => ({
       set((s) => ({
         notices: [...s.notices, next],
         _noticeQueue: rest,
-        _noticeTimer: setTimeout(() => get()._drainNoticeQueue(), NOTICE_INTERVAL_MS)
+        _noticeTimer: setTimeout(
+          () => get()._drainNoticeQueue(),
+          NOTICE_INTERVAL_MS
+        )
       }));
     } else {
       set({ _noticeTimer: null });
@@ -364,13 +370,17 @@ var useWizard = create((set, get) => ({
     await markInteraction();
     get()._resolve?.(value);
     set({ inputReq: null, _resolve: null, phase: "running" });
-    const id = get().logStart("prompt", `User input: ${describeInputValue(value)}`);
+    const id = get().logStart(
+      "prompt",
+      `User input: ${describeInputValue(value)}`
+    );
     get().logEnd(id, "success");
   },
   setDone: () => set({ phase: "done" }),
   setError: (message) => set({ phase: "error", error: message }),
   reset: () => {
     get()._clearNoticeQueue();
+    get()._resolve?.(false);
     set({
       phase: "idle",
       homeScreen: "home",
@@ -622,10 +632,13 @@ function Notices() {
 }
 
 // src/ui/PromptInput.tsx
-import { Box as Box7, Text as Text7, useInput as useInput2 } from "ink";
+import { Box as Box8, Text as Text8, useInput as useInput3 } from "ink";
 import TextInput from "ink-text-input";
 import { useState as useState5 } from "react";
 
+// src/ui/CommandApproval.tsx
+import { Box as Box5, Text as Text5, useInput } from "ink";
+
 // src/ui/NextAction.tsx
 import { Box as Box4, Text as Text4 } from "ink";
 import { Fragment, jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
@@ -649,14 +662,60 @@ function NextAction({
   ] });
 }
 
+// src/ui/CommandApproval.tsx
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+function CommandApproval({
+  command,
+  onDecide
+}) {
+  useInput((_input, key) => {
+    if (key.return) onDecide("approve");
+    else if (key.escape) onDecide("reject");
+  });
+  return /* @__PURE__ */ jsxs4(Box5, { flexDirection: "column", gap: 1, children: [
+    /* @__PURE__ */ jsx4(Text5, { color: COLORS.primary, bold: true, children: "Run this command?" }),
+    /* @__PURE__ */ jsxs4(
+      Box5,
+      {
+        flexDirection: "column",
+        paddingLeft: 2,
+        borderStyle: "single",
+        borderColor: COLORS.success,
+        borderTop: false,
+        borderBottom: false,
+        borderRight: false,
+        gap: 1,
+        children: [
+          /* @__PURE__ */ jsxs4(Box5, { children: [
+            /* @__PURE__ */ jsx4(Text5, { color: COLORS.muted, children: "$ " }),
+            /* @__PURE__ */ jsx4(Text5, { color: COLORS.strong, wrap: "wrap", children: command.command })
+          ] }),
+          /* @__PURE__ */ jsxs4(Box5, { gap: 1, children: [
+            /* @__PURE__ */ jsx4(Text5, { color: COLORS.muted, children: "in:" }),
+            /* @__PURE__ */ jsx4(Text5, { color: COLORS.muted, wrap: "wrap", children: command.cwd })
+          ] }),
+          command.explanation && /* @__PURE__ */ jsxs4(Box5, { gap: 1, children: [
+            /* @__PURE__ */ jsx4(Text5, { color: COLORS.muted, children: "why:" }),
+            /* @__PURE__ */ jsx4(Text5, { color: COLORS.accent, wrap: "wrap", children: command.explanation })
+          ] })
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsxs4(Box5, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx4(NextAction, { action: "approve", keyHint: "enter" }),
+      /* @__PURE__ */ jsx4(NextAction, { action: "reject", keyHint: "esc", hierarchy: "secondary" })
+    ] })
+  ] });
+}
+
 // src/ui/SelectPrompt.tsx
-import { Box as Box6, Text as Text6, useInput, useWindowSize as useWindowSize5 } from "ink";
+import { Box as Box7, Text as Text7, useInput as useInput2, useWindowSize as useWindowSize5 } from "ink";
 import { useLayoutEffect as useLayoutEffect2, useRef as useRef3, useState as useState4 } from "react";
 
 // src/ui/ScrollView.tsx
-import { Box as Box5, Text as Text5, measureElement as measureElement2, useWindowSize as useWindowSize4 } from "ink";
+import { Box as Box6, Text as Text6, measureElement as measureElement2, useWindowSize as useWindowSize4 } from "ink";
 import { useCallback, useLayoutEffect, useRef as useRef2, useState as useState3 } from "react";
-import { jsxs as jsxs4 } from "react/jsx-runtime";
+import { jsxs as jsxs5 } from "react/jsx-runtime";
 var INDICATOR_ROWS = 2;
 function fittedWidth(node, columns) {
   let left = 0;
@@ -726,14 +785,14 @@ function useScrollWindow({
   };
 }
 function ScrollView({ scroll, children }) {
-  return /* @__PURE__ */ jsxs4(Box5, { ref: scroll.viewportRef, flexDirection: "column", flexGrow: 1, children: [
-    scroll.hiddenAbove > 0 && /* @__PURE__ */ jsxs4(Text5, { color: COLORS.dim, children: [
+  return /* @__PURE__ */ jsxs5(Box6, { ref: scroll.viewportRef, flexDirection: "column", flexGrow: 1, children: [
+    scroll.hiddenAbove > 0 && /* @__PURE__ */ jsxs5(Text6, { color: COLORS.dim, children: [
       "\u2191 ",
       scroll.hiddenAbove,
       " more"
     ] }),
     children,
-    scroll.hiddenBelow > 0 && /* @__PURE__ */ jsxs4(Text5, { color: COLORS.dim, children: [
+    scroll.hiddenBelow > 0 && /* @__PURE__ */ jsxs5(Text6, { color: COLORS.dim, children: [
       "\u2193 ",
       scroll.hiddenBelow,
       " more"
@@ -742,7 +801,7 @@ function ScrollView({ scroll, children }) {
 }
 
 // src/ui/SelectPrompt.tsx
-import { jsx as jsx4, jsxs as jsxs5 } from "react/jsx-runtime";
+import { jsx as jsx5, jsxs as jsxs6 } from "react/jsx-runtime";
 var CANCEL = "cancel";
 var ARROW_WIDTH = 4;
 var COLUMN_GAP = 2;
@@ -804,7 +863,7 @@ function SelectPrompt({
     revealIndex(index);
   }, [index, revealIndex]);
   const visible = rows.slice(scroll.offset, scroll.offset + scroll.capacity);
-  useInput((input, key) => {
+  useInput2((input, key) => {
     if (rows.length === 0) return;
     if (key.upArrow || input === "k") {
       setIndex((i) => (i - 1 + rows.length) % rows.length);
@@ -827,56 +886,56 @@ function SelectPrompt({
       }
     }
   });
-  return /* @__PURE__ */ jsx4(Box6, { ref: containerRef, flexGrow: 1, children: /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", gap: 1, width, children: [
-    /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", gap: 1, flexShrink: 0, children: [
-      error && /* @__PURE__ */ jsx4(Text6, { color: COLORS.danger, children: error }),
-      messages?.map((m, i) => /* @__PURE__ */ jsx4(Text6, { color: COLORS.muted, children: m }, `msg-${i}`)),
-      table && /* @__PURE__ */ jsx4(Table, { columns: table.columns, rows: table.rows }),
-      /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", children: [
-        question && /* @__PURE__ */ jsx4(Text6, { color: COLORS.muted, children: question }),
-        helpText && /* @__PURE__ */ jsx4(Text6, { color: COLORS.dim, children: helpText })
+  return /* @__PURE__ */ jsx5(Box7, { ref: containerRef, flexGrow: 1, children: /* @__PURE__ */ jsxs6(Box7, { flexDirection: "column", gap: 1, width, children: [
+    /* @__PURE__ */ jsxs6(Box7, { flexDirection: "column", gap: 1, flexShrink: 0, children: [
+      error && /* @__PURE__ */ jsx5(Text7, { color: COLORS.danger, children: error }),
+      messages?.map((m, i) => /* @__PURE__ */ jsx5(Text7, { color: COLORS.muted, children: m }, `msg-${i}`)),
+      table && /* @__PURE__ */ jsx5(Table, { columns: table.columns, rows: table.rows }),
+      /* @__PURE__ */ jsxs6(Box7, { flexDirection: "column", children: [
+        question && /* @__PURE__ */ jsx5(Text7, { color: COLORS.muted, children: question }),
+        helpText && /* @__PURE__ */ jsx5(Text7, { color: COLORS.dim, children: helpText })
       ] })
     ] }),
-    /* @__PURE__ */ jsx4(ScrollView, { scroll, children: visible.map((option, visibleIndex) => {
+    /* @__PURE__ */ jsx5(ScrollView, { scroll, children: visible.map((option, visibleIndex) => {
       const i = scroll.offset + visibleIndex;
       const highlighted = i === index;
       const isCancel = i === cancelIndex;
       const bullet = multi && !isCancel ? checked.has(i) ? "\u25CF " : "\u25CB " : "";
       const sec = isCancel ? void 0 : secondary?.[i];
       const labelColor = highlighted ? COLORS.highlight.fg : void 0;
-      const label = /* @__PURE__ */ jsxs5(Text6, { color: labelColor, wrap: "truncate", children: [
+      const label = /* @__PURE__ */ jsxs6(Text7, { color: labelColor, wrap: "truncate", children: [
         highlighted ? "\u276F   " : "    ",
         bullet,
         option
       ] });
       const isText = sec?.kind === "text";
-      return /* @__PURE__ */ jsxs5(
-        Box6,
+      return /* @__PURE__ */ jsxs6(
+        Box7,
         {
           width: isText ? "100%" : barWidth,
           paddingX: 1,
           paddingY: 1,
           backgroundColor: highlighted ? COLORS.highlight.bg : void 0,
           children: [
-            /* @__PURE__ */ jsx4(Box6, { width: isText ? labelWidth : barLabelWidth, children: label }),
-            isText && textWidth > 0 && /* @__PURE__ */ jsx4(Box6, { width: textWidth, children: /* @__PURE__ */ jsx4(
-              Text6,
+            /* @__PURE__ */ jsx5(Box7, { width: isText ? labelWidth : barLabelWidth, children: label }),
+            isText && textWidth > 0 && /* @__PURE__ */ jsx5(Box7, { width: textWidth, children: /* @__PURE__ */ jsx5(
+              Text7,
               {
                 wrap: "truncate",
                 color: highlighted ? COLORS.primary : COLORS.muted,
                 children: sec.value
               }
             ) }),
-            sec?.kind === "badge" && /* @__PURE__ */ jsx4(Box6, { width: badgeWidth, justifyContent: "flex-end", children: /* @__PURE__ */ jsx4(Text6, { color: COLORS.badge, wrap: "truncate", children: sec.value }) })
+            sec?.kind === "badge" && /* @__PURE__ */ jsx5(Box7, { width: badgeWidth, justifyContent: "flex-end", children: /* @__PURE__ */ jsx5(Text7, { color: COLORS.badge, wrap: "truncate", children: sec.value }) })
           ]
         },
         `row-${i}`
       );
     }) }),
-    /* @__PURE__ */ jsx4(Box6, { flexShrink: 0, children: /* @__PURE__ */ jsx4(Text6, { children: hints.map(({ key, label }, i) => /* @__PURE__ */ jsxs5(Text6, { children: [
+    /* @__PURE__ */ jsx5(Box7, { flexShrink: 0, children: /* @__PURE__ */ jsx5(Text7, { children: hints.map(({ key, label }, i) => /* @__PURE__ */ jsxs6(Text7, { children: [
       i > 0 ? "   " : "",
-      /* @__PURE__ */ jsx4(Text6, { color: COLORS.primary, children: key }),
-      /* @__PURE__ */ jsxs5(Text6, { color: COLORS.dim, children: [
+      /* @__PURE__ */ jsx5(Text7, { color: COLORS.primary, children: key }),
+      /* @__PURE__ */ jsxs6(Text7, { color: COLORS.dim, children: [
         " ",
         label
       ] })
@@ -885,23 +944,23 @@ function SelectPrompt({
 }
 
 // src/ui/PromptInput.tsx
-import { jsx as jsx5, jsxs as jsxs6 } from "react/jsx-runtime";
+import { jsx as jsx6, jsxs as jsxs7 } from "react/jsx-runtime";
 var ACCEPT_REJECT_OPTIONS = ["Accept", "Reject"];
 function EnterToContinuePrompt({
   question,
   messages,
   onDecide
 }) {
-  useInput2((_input, key) => {
+  useInput3((_input, key) => {
     if (key.return) onDecide(true);
     else if (key.escape) onDecide(false);
   });
-  return /* @__PURE__ */ jsxs6(Box7, { flexDirection: "column", gap: 1, children: [
-    messages?.map((m, i) => /* @__PURE__ */ jsx5(Text7, { color: COLORS.muted, children: m }, `msg-${i}`)),
-    question && /* @__PURE__ */ jsx5(Text7, { color: COLORS.primary, children: question }),
-    /* @__PURE__ */ jsxs6(Box7, { gap: 1, flexDirection: "column", children: [
-      /* @__PURE__ */ jsx5(NextAction, { action: "continue", keyHint: "enter" }),
-      /* @__PURE__ */ jsx5(NextAction, { action: "decline", keyHint: "esc", hierarchy: "secondary" })
+  return /* @__PURE__ */ jsxs7(Box8, { flexDirection: "column", gap: 1, children: [
+    messages?.map((m, i) => /* @__PURE__ */ jsx6(Text8, { color: COLORS.muted, children: m }, `msg-${i}`)),
+    question && /* @__PURE__ */ jsx6(Text8, { color: COLORS.primary, children: question }),
+    /* @__PURE__ */ jsxs7(Box8, { gap: 1, flexDirection: "column", children: [
+      /* @__PURE__ */ jsx6(NextAction, { action: "continue", keyHint: "enter" }),
+      /* @__PURE__ */ jsx6(NextAction, { action: "decline", keyHint: "esc", hierarchy: "secondary" })
     ] })
   ] });
 }
@@ -909,11 +968,11 @@ function PromptInput() {
   const { phase, inputReq, submitInput } = useWizard();
   const [draft, setDraft] = useState5("");
   if (phase === "done" || phase === "error") {
-    return /* @__PURE__ */ jsx5(Box7, { marginTop: 1, children: /* @__PURE__ */ jsx5(Text7, { color: "gray", dimColor: true, children: "Press Enter or Esc to exit" }) });
+    return /* @__PURE__ */ jsx6(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx6(Text8, { color: "gray", dimColor: true, children: "Press Enter or Esc to exit" }) });
   }
   if (phase !== "awaitingInput" || !inputReq) return null;
   if (inputReq.promptType === "multipleChoice") {
-    return /* @__PURE__ */ jsx5(Box7, { flexGrow: 1, children: /* @__PURE__ */ jsx5(
+    return /* @__PURE__ */ jsx6(Box8, { flexGrow: 1, children: /* @__PURE__ */ jsx6(
       SelectPrompt,
       {
         question: inputReq.prompt,
@@ -930,7 +989,7 @@ function PromptInput() {
     ) });
   }
   if (inputReq.promptType === "multiSelect") {
-    return /* @__PURE__ */ jsx5(Box7, { flexGrow: 1, children: /* @__PURE__ */ jsx5(
+    return /* @__PURE__ */ jsx6(Box8, { flexGrow: 1, children: /* @__PURE__ */ jsx6(
       SelectPrompt,
       {
         multi: true,
@@ -945,7 +1004,7 @@ function PromptInput() {
     ) });
   }
   if (inputReq.promptType === "notice") {
-    return /* @__PURE__ */ jsx5(Box7, { flexGrow: 1, children: /* @__PURE__ */ jsx5(
+    return /* @__PURE__ */ jsx6(Box8, { flexGrow: 1, children: /* @__PURE__ */ jsx6(
       SelectPrompt,
       {
         question: inputReq.prompt,
@@ -956,7 +1015,7 @@ function PromptInput() {
     ) });
   }
   if (inputReq.promptType === "enterToContinue") {
-    return /* @__PURE__ */ jsx5(
+    return /* @__PURE__ */ jsx6(
       EnterToContinuePrompt,
       {
         question: inputReq.prompt,
@@ -965,9 +1024,12 @@ function PromptInput() {
       }
     );
   }
+  if (inputReq.promptType === "commandApproval" && inputReq.command) {
+    return /* @__PURE__ */ jsx6(CommandApproval, { command: inputReq.command, onDecide: submitInput });
+  }
   if (inputReq.promptType === "acceptReject") {
     const labels = inputReq.options?.length ? inputReq.options : ACCEPT_REJECT_OPTIONS;
-    return /* @__PURE__ */ jsx5(Box7, { flexGrow: 1, children: /* @__PURE__ */ jsx5(
+    return /* @__PURE__ */ jsx6(Box8, { flexGrow: 1, children: /* @__PURE__ */ jsx6(
       SelectPrompt,
       {
         question: inputReq.prompt,
@@ -978,15 +1040,15 @@ function PromptInput() {
       }
     ) });
   }
-  return /* @__PURE__ */ jsxs6(Box7, { flexDirection: "column", children: [
-    inputReq.error && /* @__PURE__ */ jsx5(Text7, { color: COLORS.danger, children: inputReq.error }),
-    inputReq.messages?.map((m, i) => /* @__PURE__ */ jsx5(Text7, { color: COLORS.muted, children: m }, `msg-${i}`)),
-    /* @__PURE__ */ jsxs6(Box7, { children: [
-      /* @__PURE__ */ jsxs6(Text7, { color: COLORS.primary, children: [
+  return /* @__PURE__ */ jsxs7(Box8, { flexDirection: "column", children: [
+    inputReq.error && /* @__PURE__ */ jsx6(Text8, { color: COLORS.danger, children: inputReq.error }),
+    inputReq.messages?.map((m, i) => /* @__PURE__ */ jsx6(Text8, { color: COLORS.muted, children: m }, `msg-${i}`)),
+    /* @__PURE__ */ jsxs7(Box8, { children: [
+      /* @__PURE__ */ jsxs7(Text8, { color: COLORS.primary, children: [
         inputReq.prompt,
         " "
       ] }),
-      /* @__PURE__ */ jsx5(
+      /* @__PURE__ */ jsx6(
         TextInput,
         {
           value: draft,
@@ -1004,7 +1066,7 @@ function PromptInput() {
 // src/ui/Welcome.tsx
 import { dirname as dirname2, join as join3 } from "node:path";
 import { fileURLToPath } from "node:url";
-import { Box as Box8, Spacer, Text as Text8, useInput as useInput3, useWindowSize as useWindowSize6 } from "ink";
+import { Box as Box9, Spacer, Text as Text9, useInput as useInput4, useWindowSize as useWindowSize6 } from "ink";
 
 // src/ui/copy/welcome.ts
 var sidebarItems = [
@@ -1031,26 +1093,21 @@ var sidebarItems = [
 ];
 
 // src/ui/Welcome.tsx
-import Image, { TerminalInfoContext, defaultTerminalInfo } from "ink-picture";
-import { jsx as jsx6, jsxs as jsxs7 } from "react/jsx-runtime";
+import Image, { InkPictureProvider } from "ink-picture";
+import { jsx as jsx7, jsxs as jsxs8 } 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__ */ jsxs7(Box8, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs7(Box8, { gap: 1, children: [
-      /* @__PURE__ */ jsx6(Text8, { color: COLORS.success, children: "\u2192" }),
-      /* @__PURE__ */ jsx6(Text8, { color: COLORS.strong, bold: true, children: title })
+  return /* @__PURE__ */ jsxs8(Box9, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs8(Box9, { gap: 1, children: [
+      /* @__PURE__ */ jsx7(Text9, { color: COLORS.success, children: "\u2192" }),
+      /* @__PURE__ */ jsx7(Text9, { color: COLORS.strong, bold: true, children: title })
     ] }),
-    /* @__PURE__ */ jsxs7(Box8, { flexDirection: "row", gap: 2, children: [
-      /* @__PURE__ */ jsx6(Spacer, {}),
-      /* @__PURE__ */ jsx6(Text8, { color: COLORS.muted, children: description })
+    /* @__PURE__ */ jsxs8(Box9, { flexDirection: "row", gap: 2, children: [
+      /* @__PURE__ */ jsx7(Spacer, {}),
+      /* @__PURE__ */ jsx7(Text9, { color: COLORS.muted, children: description })
     ] })
   ] });
 }
@@ -1058,7 +1115,7 @@ function Welcome() {
   const confirmStart = useWizard((s) => s.confirmStart);
   const openLearnMore = useWizard((s) => s.openLearnMore);
   const { rows } = useWindowSize6();
-  useInput3((input, key) => {
+  useInput4((input, key) => {
     if (key.return) confirmStart();
     else if (input === "i") openLearnMore();
   });
@@ -1076,16 +1133,16 @@ function Welcome() {
   if (rows < 30) {
     layout = scales["small"];
   }
-  return /* @__PURE__ */ jsxs7(Box8, { flexDirection: "row", justifyContent: "space-between", width: "100%", children: [
-    /* @__PURE__ */ jsx6(
-      Box8,
+  return /* @__PURE__ */ jsxs8(Box9, { flexDirection: "row", justifyContent: "space-between", width: "100%", children: [
+    /* @__PURE__ */ jsx7(
+      Box9,
       {
         paddingY: layout.main.padding.y,
         paddingX: layout.main.padding.x,
         flexDirection: "column",
         justifyContent: "center",
-        children: /* @__PURE__ */ jsxs7(Box8, { flexDirection: "column", gap: 2, children: [
-          /* @__PURE__ */ jsx6(TerminalInfoContext.Provider, { value: TERMINAL_INFO, children: /* @__PURE__ */ jsx6(
+        children: /* @__PURE__ */ jsxs8(Box9, { flexDirection: "column", gap: 2, children: [
+          /* @__PURE__ */ jsx7(InkPictureProvider, { children: /* @__PURE__ */ jsx7(
             Image,
             {
               src: IMAGE_PATH,
@@ -1096,16 +1153,16 @@ function Welcome() {
               protocol: "halfBlock"
             }
           ) }),
-          /* @__PURE__ */ jsx6(Text8, { color: COLORS.muted, children: "\u2726 From zero \u2192 working search in ~10 minutes" }),
-          /* @__PURE__ */ jsxs7(Box8, { gap: 1, flexDirection: "column", children: [
-            /* @__PURE__ */ jsx6(NextAction, { action: "start wizard", keyHint: "enter" }),
-            /* @__PURE__ */ jsx6(NextAction, { action: "learn more", keyHint: "i", hierarchy: "secondary" })
+          /* @__PURE__ */ jsx7(Text9, { color: COLORS.muted, children: "\u2726 From zero \u2192 working search in ~10 minutes" }),
+          /* @__PURE__ */ jsxs8(Box9, { gap: 1, flexDirection: "column", children: [
+            /* @__PURE__ */ jsx7(NextAction, { action: "start wizard", keyHint: "enter" }),
+            /* @__PURE__ */ jsx7(NextAction, { action: "learn more", keyHint: "i", hierarchy: "secondary" })
           ] })
         ] })
       }
     ),
-    /* @__PURE__ */ jsxs7(
-      Box8,
+    /* @__PURE__ */ jsxs8(
+      Box9,
       {
         backgroundColor: COLORS.bg.sidebar,
         width: 40,
@@ -1115,8 +1172,8 @@ function Welcome() {
         flexDirection: "column",
         justifyContent: "center",
         children: [
-          /* @__PURE__ */ jsx6(Text8, { color: COLORS.muted, children: "WHAT THIS WIZARD WILL DO" }),
-          sidebarItems.map((i, idx) => /* @__PURE__ */ jsx6(SidebarItem, { title: i.title, description: i.description }, idx))
+          /* @__PURE__ */ jsx7(Text9, { color: COLORS.muted, children: "WHAT THIS WIZARD WILL DO" }),
+          sidebarItems.map((i, idx) => /* @__PURE__ */ jsx7(SidebarItem, { title: i.title, description: i.description }, idx))
         ]
       }
     )
@@ -1125,7 +1182,7 @@ function Welcome() {
 
 // src/ui/LearnMore.tsx
 import { Fragment as Fragment2 } from "react";
-import { Box as Box9, Text as Text9, useInput as useInput4, useWindowSize as useWindowSize7 } from "ink";
+import { Box as Box10, Text as Text10, useInput as useInput5, useWindowSize as useWindowSize7 } from "ink";
 
 // src/ui/copy/learn-more.ts
 var accessIntro = "Everything runs locally on your machine. Nothing is written or sent without an explicit yes from you.";
@@ -1133,12 +1190,17 @@ var accessItems = [
   {
     tag: "READ",
     title: "Project files",
-    description: "reads package.json, configs & source to detect your stack. Read-only; nothing is uploaded."
+    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). Shown as a diff first \u2014 nothing lands without your approval."
+    description: "creates & edits files (search UI, config) in a throwaway git worktree \u2014 your checkout is never touched."
+  },
+  {
+    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",
@@ -1148,13 +1210,13 @@ var accessItems = [
   {
     tag: "KEY",
     title: "Credentials",
-    description: "saves your Admin API key to .env and adds it to .gitignore."
+    description: "writes your Algolia app id and a search-only key (safe to expose) to .env in the worktree."
   }
 ];
 var neverItems = [
   "Send your source code to a model or third party",
   "Commit or push to git",
-  "Touch files outside your project directory"
+  "Run a command you haven't approved"
 ];
 var policyLinks = [
   { label: "Terms", url: "https://www.algolia.com/policies/terms" },
@@ -1162,10 +1224,11 @@ var policyLinks = [
 ];
 
 // src/ui/LearnMore.tsx
-import { jsx as jsx7, jsxs as jsxs8 } from "react/jsx-runtime";
+import { jsx as jsx8, jsxs as jsxs9 } from "react/jsx-runtime";
 var TAG_COLORS = {
   READ: COLORS.success,
   WRITE: COLORS.badge,
+  EXEC: COLORS.danger,
   NET: COLORS.accent,
   KEY: COLORS.muted
 };
@@ -1178,12 +1241,12 @@ function NeverLine({
 }) {
   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__ */ jsxs8(Text9, { children: [
-    /* @__PURE__ */ jsx7(Text9, { color: COLORS.danger, children: "\u2502" }),
+  return /* @__PURE__ */ jsxs9(Text10, { children: [
+    /* @__PURE__ */ jsx8(Text10, { color: COLORS.danger, children: "\u2502" }),
     " ".repeat(NEVER_BOX_PAD_X),
-    segments.map((s, i) => /* @__PURE__ */ jsx7(Text9, { color: s.color, bold: s.bold, children: s.text }, i)),
+    segments.map((s, i) => /* @__PURE__ */ jsx8(Text10, { color: s.color, bold: s.bold, children: s.text }, i)),
     " ".repeat(rightPad),
-    /* @__PURE__ */ jsx7(Text9, { color: COLORS.danger, children: "\u2502" })
+    /* @__PURE__ */ jsx8(Text10, { color: COLORS.danger, children: "\u2502" })
   ] });
 }
 function LearnMore() {
@@ -1191,12 +1254,12 @@ function LearnMore() {
   const backToHome = useWizard((s) => s.backToHome);
   const { columns } = useWindowSize7();
   const dividerWidth = Math.max(0, columns - PADDING_X * 2);
-  useInput4((_input, key) => {
+  useInput5((_input, key) => {
     if (key.escape) backToHome();
     else if (key.return) confirmStart();
   });
-  return /* @__PURE__ */ jsxs8(
-    Box9,
+  return /* @__PURE__ */ jsxs9(
+    Box10,
     {
       flexDirection: "column",
       paddingX: PADDING_X,
@@ -1204,31 +1267,31 @@ function LearnMore() {
       width: "100%",
       gap: 1,
       children: [
-        /* @__PURE__ */ jsx7(Text9, { color: COLORS.strong, bold: true, children: "What algolia wizard accesses" }),
-        /* @__PURE__ */ jsx7(Text9, { color: COLORS.muted, children: accessIntro }),
-        /* @__PURE__ */ jsx7(Box9, { flexDirection: "column", children: accessItems.map((item) => /* @__PURE__ */ jsxs8(Box9, { flexDirection: "column", marginTop: 1, children: [
-          /* @__PURE__ */ jsx7(Text9, { color: COLORS.border, children: "\u2500".repeat(dividerWidth) }),
-          /* @__PURE__ */ jsxs8(Box9, { flexDirection: "row", gap: 1, marginTop: 1, children: [
-            /* @__PURE__ */ jsx7(Box9, { width: TAG_COLUMN_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx7(Text9, { color: TAG_COLORS[item.tag], bold: true, children: `[${item.tag}]` }) }),
-            /* @__PURE__ */ jsx7(Box9, { flexDirection: "column", children: /* @__PURE__ */ jsxs8(Text9, { children: [
-              /* @__PURE__ */ jsx7(Text9, { color: COLORS.strong, bold: true, children: item.title }),
-              /* @__PURE__ */ jsx7(Text9, { color: COLORS.muted, children: ` \u2014 ${item.description}` })
+        /* @__PURE__ */ jsx8(Text10, { color: COLORS.strong, bold: true, children: "What algolia wizard accesses" }),
+        /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: accessIntro }),
+        /* @__PURE__ */ jsx8(Box10, { flexDirection: "column", children: accessItems.map((item) => /* @__PURE__ */ jsxs9(Box10, { flexDirection: "column", marginTop: 1, children: [
+          /* @__PURE__ */ jsx8(Text10, { color: COLORS.border, children: "\u2500".repeat(dividerWidth) }),
+          /* @__PURE__ */ jsxs9(Box10, { flexDirection: "row", gap: 1, marginTop: 1, children: [
+            /* @__PURE__ */ jsx8(Box10, { width: TAG_COLUMN_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx8(Text10, { color: TAG_COLORS[item.tag], bold: true, children: `[${item.tag}]` }) }),
+            /* @__PURE__ */ jsx8(Box10, { flexDirection: "column", children: /* @__PURE__ */ jsxs9(Text10, { children: [
+              /* @__PURE__ */ jsx8(Text10, { color: COLORS.strong, bold: true, children: item.title }),
+              /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: ` \u2014 ${item.description}` })
             ] }) })
           ] })
         ] }, item.tag)) }),
-        /* @__PURE__ */ jsxs8(Box9, { marginTop: 1, flexDirection: "column", children: [
-          /* @__PURE__ */ jsx7(Text9, { color: COLORS.danger, children: `\u256D${"\u2500".repeat(Math.max(0, dividerWidth - 2))}\u256E` }),
-          /* @__PURE__ */ jsx7(NeverLine, { width: dividerWidth }),
-          /* @__PURE__ */ jsx7(
+        /* @__PURE__ */ jsxs9(Box10, { marginTop: 1, flexDirection: "column", children: [
+          /* @__PURE__ */ jsx8(Text10, { color: COLORS.danger, children: `\u256D${"\u2500".repeat(Math.max(0, dividerWidth - 2))}\u256E` }),
+          /* @__PURE__ */ jsx8(NeverLine, { width: dividerWidth }),
+          /* @__PURE__ */ jsx8(
             NeverLine,
             {
               width: dividerWidth,
               segments: [{ text: "I NEVER", color: COLORS.danger, bold: true }]
             }
           ),
-          neverItems.map((item) => /* @__PURE__ */ jsxs8(Fragment2, { children: [
-            /* @__PURE__ */ jsx7(NeverLine, { width: dividerWidth }),
-            /* @__PURE__ */ jsx7(
+          neverItems.map((item) => /* @__PURE__ */ jsxs9(Fragment2, { children: [
+            /* @__PURE__ */ jsx8(NeverLine, { width: dividerWidth }),
+            /* @__PURE__ */ jsx8(
               NeverLine,
               {
                 width: dividerWidth,
@@ -1240,24 +1303,24 @@ function LearnMore() {
               }
             )
           ] }, item)),
-          /* @__PURE__ */ jsx7(NeverLine, { width: dividerWidth }),
-          /* @__PURE__ */ jsx7(Text9, { color: COLORS.danger, children: `\u2570${"\u2500".repeat(Math.max(0, dividerWidth - 2))}\u256F` })
+          /* @__PURE__ */ jsx8(NeverLine, { width: dividerWidth }),
+          /* @__PURE__ */ jsx8(Text10, { color: COLORS.danger, children: `\u2570${"\u2500".repeat(Math.max(0, dividerWidth - 2))}\u256F` })
         ] }),
-        /* @__PURE__ */ jsx7(Box9, { marginTop: 1, flexDirection: "column", children: policyLinks.map((link) => /* @__PURE__ */ jsxs8(Box9, { flexDirection: "row", gap: 1, children: [
-          /* @__PURE__ */ jsx7(Text9, { color: COLORS.strong, bold: true, children: `${link.label}:` }),
-          /* @__PURE__ */ jsx7(Text9, { color: COLORS.accent, children: link.url })
+        /* @__PURE__ */ jsx8(Box10, { marginTop: 1, flexDirection: "column", children: policyLinks.map((link) => /* @__PURE__ */ jsxs9(Box10, { flexDirection: "row", gap: 1, children: [
+          /* @__PURE__ */ jsx8(Text10, { color: COLORS.strong, bold: true, children: `${link.label}:` }),
+          /* @__PURE__ */ jsx8(Text10, { color: COLORS.accent, children: link.url })
         ] }, link.label)) }),
-        /* @__PURE__ */ jsxs8(Box9, { marginTop: 1, flexDirection: "row", gap: 3, children: [
-          /* @__PURE__ */ jsxs8(Box9, { flexDirection: "row", gap: 1, children: [
-            /* @__PURE__ */ jsx7(Text9, { color: COLORS.muted, children: "[" }),
-            /* @__PURE__ */ jsx7(Text9, { color: COLORS.primary, children: "esc" }),
-            /* @__PURE__ */ jsx7(Text9, { color: COLORS.muted, children: "] back" })
+        /* @__PURE__ */ jsxs9(Box10, { marginTop: 1, flexDirection: "row", gap: 3, children: [
+          /* @__PURE__ */ jsxs9(Box10, { flexDirection: "row", gap: 1, children: [
+            /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: "[" }),
+            /* @__PURE__ */ jsx8(Text10, { color: COLORS.primary, children: "esc" }),
+            /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: "] back" })
           ] }),
-          /* @__PURE__ */ jsxs8(Box9, { flexDirection: "row", gap: 1, children: [
-            /* @__PURE__ */ jsx7(Text9, { color: COLORS.muted, children: "[" }),
-            /* @__PURE__ */ jsx7(Text9, { color: COLORS.primary, children: "enter" }),
-            /* @__PURE__ */ jsx7(Text9, { color: COLORS.muted, children: "]" }),
-            /* @__PURE__ */ jsx7(Text9, { color: COLORS.success, bold: true, children: "start wizard" })
+          /* @__PURE__ */ jsxs9(Box10, { flexDirection: "row", gap: 1, children: [
+            /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: "[" }),
+            /* @__PURE__ */ jsx8(Text10, { color: COLORS.primary, children: "enter" }),
+            /* @__PURE__ */ jsx8(Text10, { color: COLORS.muted, children: "]" }),
+            /* @__PURE__ */ jsx8(Text10, { color: COLORS.success, bold: true, children: "start wizard" })
           ] })
         ] })
       ]
@@ -1266,10 +1329,10 @@ function LearnMore() {
 }
 
 // src/ui/Sidebar.tsx
-import { Box as Box12, Text as Text12 } from "ink";
+import { Box as Box13, Text as Text13 } from "ink";
 
 // src/ui/Steps.tsx
-import { Box as Box10, Text as Text10 } from "ink";
+import { Box as Box11, Text as Text11 } from "ink";
 import Spinner from "ink-spinner";
 
 // src/core/persistence.ts
@@ -1298,12 +1361,12 @@ async function clearWorkflowState(workflowId) {
 }
 
 // src/ui/Steps.tsx
-import { jsx as jsx8, jsxs as jsxs9 } from "react/jsx-runtime";
+import { jsx as jsx9, jsxs as jsxs10 } from "react/jsx-runtime";
 function Steps() {
   const { steps } = useWizard();
   const visibleSteps = steps.filter(isStepVisible);
-  return /* @__PURE__ */ jsx8(Box10, { flexDirection: "column", gap: 1, children: visibleSteps.map((s) => /* @__PURE__ */ jsx8(Box10, { flexDirection: "column", children: /* @__PURE__ */ jsxs9(Text10, { color: COLORS.status[s.status], children: [
-    s.status === "running" ? /* @__PURE__ */ jsx8(Spinner, { type: "dots" }) : MARKER[s.status],
+  return /* @__PURE__ */ jsx9(Box11, { flexDirection: "column", gap: 1, children: visibleSteps.map((s) => /* @__PURE__ */ jsx9(Box11, { flexDirection: "column", children: /* @__PURE__ */ jsxs10(Text11, { color: COLORS.status[s.status], children: [
+    s.status === "running" ? /* @__PURE__ */ jsx9(Spinner, { type: "dots" }) : MARKER[s.status],
     " ",
     s.title
   ] }) }, s.id)) });
@@ -1312,27 +1375,27 @@ function CurrentStep() {
   const { steps } = useWizard();
   const currentStep = steps.filter(isStepVisible).find((s) => s.status === "running");
   if (!currentStep) return null;
-  return /* @__PURE__ */ jsxs9(Text10, { color: COLORS.status.running, children: [
-    /* @__PURE__ */ jsx8(Spinner, { type: "dots" }),
+  return /* @__PURE__ */ jsxs10(Text11, { color: COLORS.status.running, children: [
+    /* @__PURE__ */ jsx9(Spinner, { type: "dots" }),
     " ",
     ` ${currentStep.title}`
   ] });
 }
 
 // src/ui/Progress.tsx
-import { Box as Box11, Text as Text11 } from "ink";
-import { jsx as jsx9, jsxs as jsxs10 } from "react/jsx-runtime";
+import { Box as Box12, Text as Text12 } from "ink";
+import { jsx as jsx10, jsxs as jsxs11 } 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__ */ jsxs10(Box11, { flexDirection: "row", gap: 1, children: [
-    /* @__PURE__ */ jsx9(Text11, { color: COLORS.muted, children: "STEP" }),
-    /* @__PURE__ */ jsx9(Text11, { bold: true, children: activeStepNumber }),
-    /* @__PURE__ */ jsx9(Text11, { bold: true, children: "/" }),
-    /* @__PURE__ */ jsx9(Text11, { bold: true, children: visibleSteps.length })
+  return /* @__PURE__ */ jsxs11(Box12, { flexDirection: "row", gap: 1, children: [
+    /* @__PURE__ */ jsx10(Text12, { color: COLORS.muted, children: "STEP" }),
+    /* @__PURE__ */ jsx10(Text12, { bold: true, children: activeStepNumber }),
+    /* @__PURE__ */ jsx10(Text12, { bold: true, children: "/" }),
+    /* @__PURE__ */ jsx10(Text12, { bold: true, children: visibleSteps.length })
   ] });
 }
 
@@ -1343,10 +1406,10 @@ var sidebarCommands = [
 ];
 
 // src/ui/Sidebar.tsx
-import { jsx as jsx10, jsxs as jsxs11 } from "react/jsx-runtime";
+import { jsx as jsx11, jsxs as jsxs12 } from "react/jsx-runtime";
 function Sidebar() {
-  return /* @__PURE__ */ jsxs11(
-    Box12,
+  return /* @__PURE__ */ jsxs12(
+    Box13,
     {
       backgroundColor: "#14171E",
       width: 30,
@@ -1355,16 +1418,16 @@ function Sidebar() {
       flexDirection: "column",
       justifyContent: "space-between",
       children: [
-        /* @__PURE__ */ jsxs11(Box12, { flexDirection: "column", gap: 1, children: [
-          /* @__PURE__ */ jsx10(Text12, { color: COLORS.muted, children: "PROGRESS" }),
-          /* @__PURE__ */ jsx10(Steps, {})
+        /* @__PURE__ */ jsxs12(Box13, { flexDirection: "column", gap: 1, children: [
+          /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: "PROGRESS" }),
+          /* @__PURE__ */ jsx11(Steps, {})
         ] }),
-        /* @__PURE__ */ jsxs11(Box12, { flexDirection: "column", gap: 1, children: [
-          /* @__PURE__ */ jsx10(Progress, {}),
-          /* @__PURE__ */ jsx10(Box12, { flexDirection: "column", children: sidebarCommands.map((c) => {
-            return /* @__PURE__ */ jsxs11(Box12, { flexDirection: "row", gap: 1, children: [
-              /* @__PURE__ */ jsx10(Text12, { color: COLORS.primary, children: `[${c.keyHint}]` }),
-              /* @__PURE__ */ jsx10(Text12, { color: COLORS.muted, children: c.description })
+        /* @__PURE__ */ jsxs12(Box13, { flexDirection: "column", gap: 1, children: [
+          /* @__PURE__ */ jsx11(Progress, {}),
+          /* @__PURE__ */ jsx11(Box13, { flexDirection: "column", children: sidebarCommands.map((c) => {
+            return /* @__PURE__ */ jsxs12(Box13, { flexDirection: "row", gap: 1, children: [
+              /* @__PURE__ */ jsx11(Text13, { color: COLORS.primary, children: `[${c.keyHint}]` }),
+              /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: c.description })
             ] });
           }) })
         ] })
@@ -1374,12 +1437,12 @@ function Sidebar() {
 }
 
 // src/ui/Ribbon.tsx
-import { Box as Box13, Text as Text13 } from "ink";
-import { jsx as jsx11, jsxs as jsxs12 } from "react/jsx-runtime";
+import { Box as Box14, Text as Text14 } from "ink";
+import { jsx as jsx12, jsxs as jsxs13 } from "react/jsx-runtime";
 function Ribbon() {
   const firstCommand = sidebarCommands[0];
-  return /* @__PURE__ */ jsxs12(
-    Box13,
+  return /* @__PURE__ */ jsxs13(
+    Box14,
     {
       backgroundColor: "#14171E",
       flexDirection: "row",
@@ -1387,11 +1450,11 @@ function Ribbon() {
       paddingX: 2,
       paddingY: 1,
       children: [
-        /* @__PURE__ */ jsx11(Progress, {}),
-        /* @__PURE__ */ jsx11(CurrentStep, {}),
-        /* @__PURE__ */ jsxs12(Box13, { flexDirection: "row", gap: 1, children: [
-          /* @__PURE__ */ jsx11(Text13, { color: COLORS.primary, children: `[${firstCommand.keyHint}]` }),
-          /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: firstCommand.description })
+        /* @__PURE__ */ jsx12(Progress, {}),
+        /* @__PURE__ */ jsx12(CurrentStep, {}),
+        /* @__PURE__ */ jsxs13(Box14, { flexDirection: "row", gap: 1, children: [
+          /* @__PURE__ */ jsx12(Text14, { color: COLORS.primary, children: `[${firstCommand.keyHint}]` }),
+          /* @__PURE__ */ jsx12(Text14, { color: COLORS.muted, children: firstCommand.description })
         ] })
       ]
     }
@@ -1402,8 +1465,8 @@ function Ribbon() {
 import { useState as useState6 } from "react";
 
 // src/ui/Logs.tsx
-import { Box as Box14, Text as Text14, useInput as useInput5 } from "ink";
-import { jsx as jsx12, jsxs as jsxs13 } from "react/jsx-runtime";
+import { Box as Box15, Text as Text15, useInput as useInput6 } from "ink";
+import { jsx as jsx13, jsxs as jsxs14 } from "react/jsx-runtime";
 var KIND_COLOR = {
   tool: COLORS.primary,
   prompt: COLORS.badge
@@ -1434,14 +1497,14 @@ function formatTimestamp(ms) {
 function Logs() {
   const logs = useWizard((s) => s.logs);
   const scroll = useScrollWindow({ itemCount: logs.length, followBottom: true });
-  useInput5((_input, key) => {
+  useInput6((_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__ */ jsxs13(Box14, { flexDirection: "column", paddingX: 4, paddingY: 2, flexGrow: 1, children: [
-    logs.length === 0 && /* @__PURE__ */ jsx12(Text14, { color: COLORS.dim, children: "No logs yet." }),
-    /* @__PURE__ */ jsx12(ScrollView, { scroll, children: visible.map((entry) => {
+  return /* @__PURE__ */ jsxs14(Box15, { flexDirection: "column", paddingX: 4, paddingY: 2, flexGrow: 1, children: [
+    logs.length === 0 && /* @__PURE__ */ jsx13(Text15, { color: COLORS.dim, children: "No logs yet." }),
+    /* @__PURE__ */ jsx13(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);
@@ -1451,14 +1514,14 @@ function Logs() {
       const name = truncate2(entry.name, budget);
       budget -= name.length;
       const preview = rawPreview ? truncate2(rawPreview, budget) : "";
-      return /* @__PURE__ */ jsxs13(Box14, { flexDirection: "row", gap: ROW_GAP, children: [
-        /* @__PURE__ */ jsx12(Text14, { color: COLORS.dim, children: timestamp }),
-        /* @__PURE__ */ jsx12(Text14, { color: logNameColor(entry), wrap: "truncate", children: name }),
-        preview && /* @__PURE__ */ jsx12(Text14, { color: COLORS.dim, wrap: "truncate", children: preview }),
-        durationText && /* @__PURE__ */ jsx12(Text14, { color: COLORS.dim, children: durationText })
+      return /* @__PURE__ */ jsxs14(Box15, { flexDirection: "row", gap: ROW_GAP, children: [
+        /* @__PURE__ */ jsx13(Text15, { color: COLORS.dim, children: timestamp }),
+        /* @__PURE__ */ jsx13(Text15, { color: logNameColor(entry), wrap: "truncate", children: name }),
+        preview && /* @__PURE__ */ jsx13(Text15, { color: COLORS.dim, wrap: "truncate", children: preview }),
+        durationText && /* @__PURE__ */ jsx13(Text15, { color: COLORS.dim, children: durationText })
       ] }, entry.id);
     }) }),
-    /* @__PURE__ */ jsx12(Text14, { color: COLORS.dim, children: "\u2191/\u2193 scroll" })
+    /* @__PURE__ */ jsx13(Text15, { color: COLORS.dim, children: "\u2191/\u2193 scroll" })
   ] });
 }
 
@@ -1650,7 +1713,7 @@ function track(event, payload) {
 }
 
 // src/ui/App.tsx
-import { jsx as jsx13, jsxs as jsxs14 } from "react/jsx-runtime";
+import { jsx as jsx14, jsxs as jsxs15 } from "react/jsx-runtime";
 function App() {
   const { phase, error, homeScreen, currentStepIndex, steps, inputReq } = useWizard();
   const { exit } = useApp();
@@ -1658,7 +1721,7 @@ function App() {
   const [showLogs, setShowLogs] = useState6(false);
   const finished = phase === "done" || phase === "error";
   const currentStep = steps[currentStepIndex];
-  useInput6(
+  useInput7(
     (_input, key) => {
       if (key.return) {
         exit();
@@ -1666,7 +1729,7 @@ function App() {
     },
     { isActive: finished }
   );
-  useInput6((_input, key) => {
+  useInput7((_input, key) => {
     if (phase === "idle" || phase === "authenticating") return;
     if (key.tab) {
       setShowLogs(!showLogs);
@@ -1677,8 +1740,8 @@ function App() {
       });
     }
   });
-  const escOwnedElsewhere = phase === "idle" || phase === "authenticating" || phase === "awaitingInput" && inputReq?.promptType === "enterToContinue";
-  useInput6((_input, key) => {
+  const escOwnedElsewhere = phase === "idle" || phase === "authenticating" || phase === "awaitingInput" && (inputReq?.promptType === "enterToContinue" || inputReq?.promptType === "commandApproval");
+  useInput7((_input, key) => {
     if (escOwnedElsewhere) return;
     if (key.escape) {
       track("AI Wizard Interaction", {
@@ -1697,8 +1760,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__ */ jsxs14(
-      Box15,
+    /* @__PURE__ */ jsxs15(
+      Box16,
       {
         backgroundColor: COLORS.bg.main,
         flexDirection: "row",
@@ -1706,16 +1769,16 @@ function App() {
         height: scrollsPastViewport ? void 0 : rows,
         overflow: scrollsPastViewport ? "visible" : "hidden",
         children: [
-          mainWindowVisible && /* @__PURE__ */ jsxs14(
-            Box15,
+          mainWindowVisible && /* @__PURE__ */ jsxs15(
+            Box16,
             {
               flexDirection,
               width: "100%",
               maxHeight: rows,
               justifyContent: "space-between",
               children: [
-                showLogs ? /* @__PURE__ */ jsx13(Logs, {}) : /* @__PURE__ */ jsxs14(
-                  Box15,
+                showLogs ? /* @__PURE__ */ jsx14(Logs, {}) : /* @__PURE__ */ jsxs15(
+                  Box16,
                   {
                     flexDirection: "column",
                     paddingX: 4,
@@ -1723,26 +1786,26 @@ function App() {
                     width: showSidebar ? 70 : "100%",
                     flexGrow: 1,
                     children: [
-                      phase === "authenticating" && /* @__PURE__ */ jsxs14(Box15, { flexDirection: "column", marginBottom: 1, children: [
-                        /* @__PURE__ */ jsx13(Text15, { color: COLORS.strong, bold: true, children: "Signing in to Algolia" }),
-                        /* @__PURE__ */ jsx13(Text15, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
+                      phase === "authenticating" && /* @__PURE__ */ jsxs15(Box16, { flexDirection: "column", marginBottom: 1, children: [
+                        /* @__PURE__ */ jsx14(Text16, { color: COLORS.strong, bold: true, children: "Signing in to Algolia" }),
+                        /* @__PURE__ */ jsx14(Text16, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
                       ] }),
-                      /* @__PURE__ */ jsx13(CliOutput, {}),
-                      /* @__PURE__ */ jsx13(Notices, {}),
-                      /* @__PURE__ */ jsx13(PromptInput, {}),
-                      phase === "running" && showSidebar && /* @__PURE__ */ jsx13(Box15, { marginTop: 1, children: /* @__PURE__ */ jsx13(CurrentStep, {}) }),
-                      phase === "error" && error && /* @__PURE__ */ jsx13(Box15, { marginTop: 1, children: /* @__PURE__ */ jsxs14(Text15, { color: COLORS.status.error, children: [
+                      /* @__PURE__ */ jsx14(CliOutput, {}),
+                      /* @__PURE__ */ jsx14(Notices, {}),
+                      /* @__PURE__ */ jsx14(PromptInput, {}),
+                      phase === "running" && showSidebar && /* @__PURE__ */ jsx14(Box16, { marginTop: 1, children: /* @__PURE__ */ jsx14(CurrentStep, {}) }),
+                      phase === "error" && error && /* @__PURE__ */ jsx14(Box16, { marginTop: 1, children: /* @__PURE__ */ jsxs15(Text16, { color: COLORS.status.error, children: [
                         "\u2716 ",
                         error
                       ] }) })
                     ]
                   }
                 ),
-                showSidebar ? /* @__PURE__ */ jsx13(Sidebar, {}) : /* @__PURE__ */ jsx13(Ribbon, {})
+                showSidebar ? /* @__PURE__ */ jsx14(Sidebar, {}) : /* @__PURE__ */ jsx14(Ribbon, {})
               ]
             }
           ),
-          phase === "idle" && (homeScreen === "learnMore" ? /* @__PURE__ */ jsx13(LearnMore, {}) : /* @__PURE__ */ jsx13(Welcome, {}))
+          phase === "idle" && (homeScreen === "learnMore" ? /* @__PURE__ */ jsx14(LearnMore, {}) : /* @__PURE__ */ jsx14(Welcome, {}))
         ]
       }
     )
@@ -1822,7 +1885,7 @@ async function ensureConsent() {
   if (config.aiConsent) return;
   const store = useWizard.getState();
   const answer = await store.requestUserInput({
-    prompt: "Wizard will make AI-authored changes to this repository.",
+    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: []
   });
@@ -2178,7 +2241,7 @@ async function ensureApplication() {
 }
 
 // src/workflows/default.ts
-import { z as z28 } from "zod";
+import { z as z29 } from "zod";
 
 // src/actions/listIndices.ts
 import { z as z5 } from "zod";
@@ -2901,13 +2964,187 @@ function verifyImplementationTool() {
   });
 }
 
+// src/lib/tools/runShell.ts
+import { tool as tool9 } from "ai";
+import z16 from "zod";
+
+// src/lib/tools/utils/runShell.ts
+import { spawn as spawn3 } from "node:child_process";
+
+// src/lib/tools/context.ts
+var DEFAULT_TOOL_LIMITS = {
+  list: 10,
+  search: 10,
+  read: 20,
+  match: 100,
+  shell: 30
+};
+var DEFAULT_SHELL_TIMEOUT_MS = 10 * 60 * 1e3;
+async function refuseByDefault() {
+  return "reject";
+}
+function createShellContext(overrides = {}) {
+  return {
+    env: async () => ({}),
+    timeoutMs: DEFAULT_SHELL_TIMEOUT_MS,
+    executions: [],
+    approve: refuseByDefault,
+    ...overrides
+  };
+}
+function createToolContext(limits = DEFAULT_TOOL_LIMITS, cwd = process.cwd(), shell2 = createShellContext()) {
+  return {
+    root: cwd,
+    cwd,
+    limits: { ...limits },
+    counts: { list: 0, search: 0, read: 0, shell: 0 },
+    shell: shell2
+  };
+}
+
+// src/lib/tools/utils/runShell.ts
+var SIGKILL_DELAY_MS = 5e3;
+var HEAD_CHARS = 4e3;
+var TAIL_CHARS = 8e3;
+function truncateOutput(output) {
+  if (output.length <= HEAD_CHARS + TAIL_CHARS) return output;
+  const omitted = output.length - HEAD_CHARS - TAIL_CHARS;
+  return [
+    output.slice(0, HEAD_CHARS),
+    `
+\u2026 [${omitted} characters omitted] \u2026
+`,
+    output.slice(-TAIL_CHARS)
+  ].join("");
+}
+function runShell(command, opts) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_SHELL_TIMEOUT_MS;
+  const startedAt = Date.now();
+  return new Promise((resolve4) => {
+    let output = "";
+    let timedOut = false;
+    let settled = false;
+    const child = spawn3(command, {
+      shell: true,
+      cwd: opts.cwd,
+      stdio: ["ignore", "pipe", "pipe"],
+      env: { ...process.env, ...opts.env }
+    });
+    const finish = (exitCode) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      clearTimeout(killTimer);
+      resolve4({
+        exitCode,
+        output: truncateOutput(output.trim()),
+        timedOut,
+        durationMs: Date.now() - startedAt
+      });
+    };
+    let killTimer;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      output += `
+[timed out after ${timeoutMs}ms]`;
+      child.kill("SIGTERM");
+      killTimer = setTimeout(() => child.kill("SIGKILL"), SIGKILL_DELAY_MS);
+    }, timeoutMs);
+    child.stdout?.on("data", (d) => output += d);
+    child.stderr?.on("data", (d) => output += d);
+    child.on("error", (err) => {
+      output += `Failed to run ${command}: ${err.message}`;
+      finish(1);
+    });
+    child.on("close", (code) => finish(code ?? 1));
+  });
+}
+
+// src/lib/tools/runShell.ts
+var shellChain = Promise.resolve();
+function serialize(work) {
+  const result = shellChain.then(work);
+  shellChain = result.catch(() => {
+  });
+  return result;
+}
+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.";
+  }
+  useWizard.getState().pushNotice({ messages: [`Running: ${command}`] });
+  const env = await ctx.shell.env().catch((err) => {
+    logger.warn({ err, command }, "runShell: could not resolve command env");
+    return {};
+  });
+  const run2 = await (ctx.shell.run ?? runShell)(command, {
+    cwd,
+    env,
+    timeoutMs: ctx.shell.timeoutMs
+  });
+  logger.info(
+    {
+      command,
+      exitCode: run2.exitCode,
+      timedOut: run2.timedOut,
+      durationMs: run2.durationMs
+    },
+    "runShell finished"
+  );
+  await markInteraction();
+  ctx.shell.executions.push({
+    command,
+    cwd,
+    approved: true,
+    exitCode: run2.exitCode,
+    output: run2.output,
+    timedOut: run2.timedOut,
+    durationMs: run2.durationMs
+  });
+  return {
+    exitCode: run2.exitCode,
+    timedOut: run2.timedOut,
+    output: run2.output
+  };
+}
+function runShellTool(ctx) {
+  return tool9({
+    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. 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.",
+    inputSchema: z16.object({
+      command: z16.string().describe(
+        "The command to run, exactly as it would be typed in a shell. Pipes, && and redirects are allowed."
+      ),
+      cwd: z16.string().optional().describe(
+        "Directory to run in, relative to the project root. Defaults to the project root."
+      ),
+      explanation: z16.string().describe(
+        "One short line telling the user what this command does and why, including any side effect (e.g. writes records to Algolia). This is what they approve against."
+      )
+    }),
+    execute: async ({ command, cwd, explanation }) => {
+      if (++ctx.counts.shell > ctx.limits.shell) {
+        return `Refused: command limit (${ctx.limits.shell}) reached. Stop running commands and report what you have.`;
+      }
+      const resolved2 = resolveInRoot(ctx, cwd ?? ".");
+      if (!resolved2.ok) return resolved2.error;
+      logger.info({ command, cwd: resolved2.target }, "called runShell tool");
+      return serialize(
+        () => approveAndRun(ctx, command, resolved2.target, explanation)
+      );
+    }
+  });
+}
+
 // src/lib/tools/generateRecord.ts
-import { tool as tool9, generateText, Output, NoObjectGeneratedError } from "ai";
+import { tool as tool10, generateText, Output, NoObjectGeneratedError } from "ai";
 import { createAnthropic } from "@ai-sdk/anthropic";
 import { nanoid as nanoid2 } from "nanoid";
 import { mkdir as mkdir5, writeFile as writeFile5 } from "node:fs/promises";
 import { dirname as dirname6 } from "node:path";
-import z16 from "zod";
+import z17 from "zod";
 var DATA_DIR = ".algolia-wizard/data";
 var RECORD_MODEL = "claude-haiku-4-5";
 var MAX_RECORDS = 100;
@@ -2917,19 +3154,19 @@ var anthropic = createAnthropic({
   apiKey: process.env.PROVIDER_API_KEY ?? ""
 });
 function generateRecordTool(ctx) {
-  return tool9({
+  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.",
-    inputSchema: z16.object({
-      entityName: z16.string().describe("Name of the entity to generate records for."),
-      attributes: z16.array(z16.string()).describe("Attribute names each record must contain."),
-      count: z16.number().int().min(1).max(MAX_RECORDS).default(10).describe(`How many records to generate (max ${MAX_RECORDS}).`),
-      hint: z16.string().optional().describe("Optional context to steer realistic values.")
+    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."),
+      count: z17.number().int().min(1).max(MAX_RECORDS).default(10).describe(`How many records to generate (max ${MAX_RECORDS}).`),
+      hint: z17.string().optional().describe("Optional context to steer realistic values.")
     }),
     execute: async ({ entityName, attributes, count, hint }) => {
       logger.info({ entityName, count }, "called generateRecord tool");
       try {
-        const value = z16.union([z16.string(), z16.number(), z16.boolean(), z16.null()]);
-        const recordSchema = z16.object(
+        const value = z17.union([z17.string(), z17.number(), z17.boolean(), z17.null()]);
+        const recordSchema = z17.object(
           Object.fromEntries(attributes.map((attr) => [attr, value]))
         );
         const generateBatch = async (batchCount) => {
@@ -2939,8 +3176,8 @@ function generateRecordTool(ctx) {
               const { output } = await generateText({
                 model: anthropic(RECORD_MODEL),
                 output: Output.object({
-                  schema: z16.object({
-                    records: z16.array(recordSchema).length(batchCount)
+                  schema: z17.object({
+                    records: z17.array(recordSchema).length(batchCount)
                   })
                 }),
                 prompt: [
@@ -2997,13 +3234,13 @@ function generateRecordTool(ctx) {
 }
 
 // src/lib/tools/notifyUser.ts
-import { tool as tool10 } from "ai";
-import z17 from "zod";
+import { tool as tool11 } from "ai";
+import z18 from "zod";
 function notifyUserTool() {
-  return tool10({
+  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.`,
-    inputSchema: z17.object({
-      message: z17.string().describe(
+    inputSchema: z18.object({
+      message: z18.string().describe(
         "Short, plain-language description of what you are doing now."
       )
     }),
@@ -3015,22 +3252,6 @@ function notifyUserTool() {
   });
 }
 
-// src/lib/tools/context.ts
-var DEFAULT_TOOL_LIMITS = {
-  list: 10,
-  search: 10,
-  read: 20,
-  match: 100
-};
-function createToolContext(limits = DEFAULT_TOOL_LIMITS, cwd = process.cwd()) {
-  return {
-    root: cwd,
-    cwd,
-    limits,
-    counts: { list: 0, search: 0, read: 0 }
-  };
-}
-
 // src/lib/tools/index.ts
 function withLogging(name, def) {
   const execute = def.execute;
@@ -3066,6 +3287,7 @@ function createTools(ctx, { output, tools }) {
       "verifyImplementation",
       verifyImplementationTool()
     ),
+    runShell: withLogging("runShell", runShellTool(ctx)),
     generateRecord: withLogging("generateRecord", generateRecordTool(ctx)),
     notifyUser: withLogging("notifyUser", notifyUserTool())
   };
@@ -3100,7 +3322,7 @@ async function runAgent(req) {
     baseURL: PROXY_BASE_URL,
     fetch: proxyFetch
   });
-  const toolContext = createToolContext();
+  const toolContext = req.toolContext ?? createToolContext();
   const readTools = ["readFile", "searchFiles", "listFiles"];
   const hasReadTools = !req.tools || req.tools.some((t) => readTools.includes(t));
   const instructions = [
@@ -3165,7 +3387,11 @@ async function runAgent(req) {
     "runAgent finished"
   );
   logger.info(
-    { counts: toolContext.counts, limits: toolContext.limits },
+    {
+      counts: toolContext.counts,
+      limits: toolContext.limits,
+      commandsRun: toolContext.shell.executions.length
+    },
     "tool usage"
   );
   const toolResults = await stream.toolResults;
@@ -3183,10 +3409,10 @@ async function runAgent(req) {
 }
 
 // src/actions/detectLanguage.ts
-import z20 from "zod";
-var detectLanguageSchema = z20.object({
-  languages: z20.array(z20.object({ name: z20.string(), version: z20.string() })),
-  frameworks: z20.array(z20.object({ name: z20.string(), version: z20.string() }))
+import z21 from "zod";
+var detectLanguageSchema = z21.object({
+  languages: z21.array(z21.object({ name: z21.string(), version: z21.string() })),
+  frameworks: z21.array(z21.object({ name: z21.string(), version: z21.string() }))
 });
 var detectLanguage = () => runAgent({
   instructions: [
@@ -3204,31 +3430,31 @@ var detectLanguage = () => runAgent({
 });
 
 // src/actions/analyzeCodebase.ts
-import z21 from "zod";
+import z22 from "zod";
 var READONLY_TOOLS = [
   "listFiles",
   "changeDirectory",
   "readFile",
   "searchFiles"
 ];
-var ingestionAnalysisSchema = z21.object({
-  ingestionAnalysis: z21.array(
-    z21.object({
-      name: z21.string(),
-      paths: z21.array(z21.string()),
+var ingestionAnalysisSchema = z22.object({
+  ingestionAnalysis: z22.array(
+    z22.object({
+      name: z22.string(),
+      paths: z22.array(z22.string()),
       // indexable fields the agent found for this entity
-      attributes: z21.array(z21.string())
+      attributes: z22.array(z22.string())
     })
   )
 });
-var searchImplementationAnalysisSchema = z21.object({
-  searchImplementationAnalysis: z21.string()
+var searchImplementationAnalysisSchema = z22.object({
+  searchImplementationAnalysis: z22.string()
 });
-var verificationSchema = z21.object({
-  verification: z21.array(z21.string())
+var verificationSchema = z22.object({
+  verification: z22.array(z22.string())
 });
 var confirmedEntitiesFieldSchema = ingestionAnalysisSchema.shape.ingestionAnalysis.optional();
-var analyzeCodebaseSchema = z21.object({
+var analyzeCodebaseSchema = z22.object({
   ingestionAnalysis: ingestionAnalysisSchema.shape.ingestionAnalysis.optional(),
   searchImplementationAnalysis: searchImplementationAnalysisSchema.shape.searchImplementationAnalysis.optional(),
   verification: verificationSchema.shape.verification.optional(),
@@ -3290,7 +3516,7 @@ async function runAnalysis(mode, extraInstructions = []) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.12.0-rc.104.151",
+  version: "0.12.0",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -3409,8 +3635,8 @@ async function askList(ctx, prompt, { required = false } = {}) {
 }
 
 // src/actions/confirmLanguage.ts
-import z23 from "zod";
-var confirmLanguageSchema = z23.object({
+import z24 from "zod";
+var confirmLanguageSchema = z24.object({
   languages: detectLanguageSchema.shape.languages
 });
 async function confirmLanguage(ctx) {
@@ -3431,8 +3657,8 @@ async function confirmLanguage(ctx) {
 }
 
 // src/actions/confirmFramework.ts
-import z24 from "zod";
-var confirmFrameworkSchema = z24.object({
+import z25 from "zod";
+var confirmFrameworkSchema = z25.object({
   frameworks: detectLanguageSchema.shape.frameworks
 });
 var CURATED_FRAMEWORKS = [
@@ -3560,8 +3786,8 @@ async function promptUser(ctx, params) {
 }
 
 // src/actions/confirmEntities.ts
-import z25 from "zod";
-var confirmEntitiesSchema = z25.object({
+import z26 from "zod";
+var confirmEntitiesSchema = z26.object({
   // Final detection — the focused re-run may supersede project-scan's.
   ingestionAnalysis: ingestionAnalysisSchema.shape.ingestionAnalysis.optional(),
   confirmedEntities: confirmedEntitiesFieldSchema
@@ -3631,15 +3857,15 @@ async function confirmEntities(ctx) {
 }
 
 // src/actions/review.ts
-import { z as z26 } from "zod";
-var reviewSchema = z26.object({
+import { z as z27 } from "zod";
+var reviewSchema = z27.object({
   // Broad, high-level takeaways grouped by theme (e.g. ingestion, search UI),
   // not one entry per workflow step — a step's raw output can be a long,
   // multi-paragraph blob (see implement.ts's summaries.join), and mirroring
   // that 1:1 is what made the old per-step summary an unreadable wall of text.
-  summaryPoints: z26.array(z26.string()),
-  reviewPrompt: z26.string(),
-  nextSteps: z26.array(z26.string())
+  summaryPoints: z27.array(z27.string()),
+  reviewPrompt: z27.string(),
+  nextSteps: z27.array(z27.string())
 });
 function formatCompletedSteps(steps) {
   if (!steps.length) return "(no prior steps completed)";
@@ -3690,10 +3916,10 @@ ${formatCompletedSteps(ctx.completedSteps)}`,
 };
 
 // src/actions/implement.ts
-import z27 from "zod";
+import z28 from "zod";
 
 // src/lib/worktree.ts
-import { execFile, spawn as spawn3 } from "node:child_process";
+import { execFile, spawn as spawn4 } from "node:child_process";
 import { copyFile, mkdir as mkdir6, readdir as readdir3, readFile as readFile8, stat as stat2, writeFile as writeFile6 } from "node:fs/promises";
 import {
   basename as basename2,
@@ -3774,7 +4000,7 @@ async function installWorktreeDeps(worktreePath) {
   const pm = await detectPackageManager(worktreePath);
   return new Promise((resolve4) => {
     let output = "";
-    const child = spawn3(pm, ["install"], {
+    const child = spawn4(pm, ["install"], {
       cwd: worktreePath,
       stdio: ["ignore", "pipe", "pipe"]
     });
@@ -3843,7 +4069,7 @@ async function runIngestScript(worktreePath, runtime, entrypoint, env = {}) {
   }
   return new Promise((resolveRun) => {
     let output = "";
-    const child = spawn3(runtime, [entrypoint], {
+    const child = spawn4(runtime, [entrypoint], {
       cwd: worktreePath,
       shell: false,
       stdio: ["ignore", "pipe", "pipe"],
@@ -4049,34 +4275,34 @@ function shellQuote(value) {
 }
 
 // src/actions/implement.ts
-var implementSchema = z27.object({
-  filesChanged: z27.array(z27.string()),
-  summary: z27.string(),
-  worktreePath: z27.string().optional(),
-  ingestCommand: z27.string().optional(),
-  ingestScriptRan: z27.boolean().optional(),
-  ingestRecordCount: z27.number().optional(),
-  ingestDurationMs: z27.number().optional(),
-  ingestionSource: z27.enum(["local", "fileUpload", "generated"]),
-  searchEnvVars: z27.array(
-    z27.object({
-      name: z27.string(),
-      value: z27.string()
+var implementSchema = z28.object({
+  filesChanged: z28.array(z28.string()),
+  summary: z28.string(),
+  worktreePath: z28.string().optional(),
+  ingestCommand: z28.string().optional(),
+  ingestScriptRan: z28.boolean().optional(),
+  ingestRecordCount: z28.number().optional(),
+  ingestDurationMs: z28.number().optional(),
+  ingestionSource: z28.enum(["local", "fileUpload", "generated"]),
+  searchEnvVars: z28.array(
+    z28.object({
+      name: z28.string(),
+      value: z28.string()
     })
   ).optional()
 });
-var implementationOutputSchema = z27.object({
-  summary: z27.string(),
+var implementationOutputSchema = z28.object({
+  summary: z28.string(),
   // Ingestion only: a structured pair the wizard turns into an argv, never a
   // free-form command string. `runtime` is allowlisted and `entrypoint` is
   // validated worktree-relative, so the agent cannot inject extra commands.
-  runtime: z27.enum(INGEST_RUNTIMES).optional(),
-  entrypoint: z27.string().optional()
+  runtime: z28.enum(INGEST_RUNTIMES).optional(),
+  entrypoint: z28.string().optional()
 });
-var verificationOutputSchema = z27.object({
-  summary: z27.string(),
-  sufficient: z27.boolean(),
-  additionalInstructions: z27.string().optional()
+var verificationOutputSchema = z28.object({
+  summary: z28.string(),
+  sufficient: z28.boolean(),
+  additionalInstructions: z28.string().optional()
 });
 var MAX_IMPLEMENT_VERIFICATION_ATTEMPTS = 3;
 var DEFAULT_IMPLEMENT_USE_CASES = ["ingestion", "search"];
@@ -4754,8 +4980,8 @@ var defaultWorkflow = {
     defineStep({
       id: "select-index",
       title: "Set up index",
-      outputSchema: z28.object({
-        selection: z28.string()
+      outputSchema: z29.object({
+        selection: z29.string()
       }),
       run: (ctx) => selectIndexStep(ctx)
     }),
@@ -5059,7 +5285,7 @@ async function resetProjectState() {
 }
 
 // src/main.tsx
-import { jsx as jsx14 } from "react/jsx-runtime";
+import { jsx as jsx15 } from "react/jsx-runtime";
 async function startup() {
   setProjectRoot(process.cwd());
   let args;
@@ -5109,7 +5335,7 @@ ${formatStepList(workflow)}`);
 }
 async function run(workflow) {
   const store = useWizard.getState();
-  const instance = render(/* @__PURE__ */ jsx14(App, {}), { incrementalRendering: true });
+  const instance = render(/* @__PURE__ */ jsx15(App, {}), { incrementalRendering: true });
   await store.waitForStart();
   let user = await getUser();
   if (!user) {