@algolia/wizard 0.29.0-rc.118.223 → 0.29.0

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";
 import Spinner2 from "ink-spinner";
 
 // src/core/store.ts
@@ -489,7 +489,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
@@ -548,31 +548,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(
@@ -593,10 +568,13 @@ function parseHex(hex) {
     b: parseInt(n.slice(4, 6), 16)
   };
 }
-function Notices() {
+function Notices({
+  showAll = false,
+  border = true
+} = {}) {
   const notices = useWizard((s) => s.notices);
-  const { rows: windowRows } = useWindowSize3();
-  const visible = fitVisibleNotices(notices, windowRows);
+  const latest = notices[notices.length - 1];
+  const visible = showAll ? notices : latest ? [latest] : [];
   const [pulseStep, setPulseStep] = useState2(0);
   useEffect2(() => {
     let direction = 1;
@@ -610,30 +588,41 @@ function Notices() {
     }, PULSE_STEP_MS);
     return () => clearInterval(id);
   }, []);
-  if (!visible.length) return null;
+  if (visible.length === 0) 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__ */ jsx2(
+    Box3,
+    {
+      borderColor: border ? COLORS.border : void 0,
+      borderStyle: border ? "single" : void 0,
+      borderBackgroundColor: COLORS.bg.main,
+      borderLeft: false,
+      borderRight: false,
+      borderBottom: false,
+      paddingTop: border ? 1 : 0,
+      flexDirection: "column",
+      gap: 1,
+      children: visible.map((notice, i) => /* @__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: !line.color ? notice === latest ? pulseColor : COLORS.dim : line.color ?? COLORS.dim,
+              bold: line.bold,
+              children: [
+                prefix,
+                line.text
+              ]
+            },
+            `notice-line-${j}`
+          );
+        }),
+        notice.table && /* @__PURE__ */ jsx2(Table, { columns: notice.table.columns, rows: notice.table.rows })
+      ] }, `notice-${i}`))
+    }
+  );
 }
 
 // src/ui/PromptInput.tsx
@@ -714,11 +703,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;
@@ -735,7 +724,7 @@ function useScrollWindow({
   followBottom = false
 }) {
   const viewportRef = useRef2(null);
-  const { columns } = useWindowSize4();
+  const { columns } = useWindowSize3();
   const [size, setSize] = useState3(
     null
   );
@@ -876,7 +865,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;
@@ -1105,7 +1094,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 = [
@@ -1158,7 +1147,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 }
@@ -1251,7 +1240,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.";
@@ -1321,7 +1310,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();
@@ -1531,7 +1520,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";
@@ -1781,15 +1770,303 @@ 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, user } = useWizard();
+  const {
+    phase,
+    error,
+    homeScreen,
+    currentStepIndex,
+    steps,
+    inputReq,
+    user,
+    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];
+  const isInitialAnalysisStep = currentStepIndex === 0;
+  const isAwaitingUserInput = phase === "awaitingInput" && !!inputReq;
+  const showTips = phase === "running" && isInitialAnalysisStep && notices.length > 0;
+  const showNoticesInMain = !isInitialAnalysisStep;
+  const showNotices = !isAwaitingUserInput;
   useInput7(
     (_input, key) => {
       if (key.return) {
@@ -1829,8 +2106,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",
@@ -1838,53 +2115,58 @@ 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 === "preflight" && !user && /* @__PURE__ */ jsx15(Box17, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs16(Text17, { color: COLORS.strong, bold: true, children: [
-                        /* @__PURE__ */ jsx15(Spinner2, { type: "dots" }),
-                        " Signing in to Algolia"
-                      ] }) }),
-                      phase === "preflight" && user && /* @__PURE__ */ jsx15(Box17, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs16(Text17, { color: COLORS.strong, bold: true, children: [
-                        /* @__PURE__ */ jsx15(Spinner2, { type: "dots" }),
-                        " Getting things ready"
-                      ] }) }),
-                      phase === "authenticating" && /* @__PURE__ */ jsxs16(Box17, { flexDirection: "column", marginBottom: 1, children: [
-                        /* @__PURE__ */ jsxs16(Text17, { color: COLORS.strong, bold: true, children: [
-                          /* @__PURE__ */ jsx15(Spinner2, { type: "dots" }),
+                      /* @__PURE__ */ jsxs17(Box19, { flexGrow: 2, flexDirection: "column", children: [
+                        phase === "preflight" && !user && /* @__PURE__ */ jsx17(Box19, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs17(Text19, { color: COLORS.strong, bold: true, children: [
+                          /* @__PURE__ */ jsx17(Spinner2, { type: "dots" }),
                           " Signing in to Algolia"
+                        ] }) }),
+                        phase === "preflight" && user && /* @__PURE__ */ jsx17(Box19, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs17(Text19, { color: COLORS.strong, bold: true, children: [
+                          /* @__PURE__ */ jsx17(Spinner2, { type: "dots" }),
+                          " Getting things ready"
+                        ] }) }),
+                        phase === "authenticating" && /* @__PURE__ */ jsxs17(Box19, { flexDirection: "column", marginBottom: 1, children: [
+                          /* @__PURE__ */ jsxs17(Text19, { color: COLORS.strong, bold: true, children: [
+                            /* @__PURE__ */ jsx17(Spinner2, { type: "dots" }),
+                            " Signing in to Algolia"
+                          ] }),
+                          /* @__PURE__ */ jsx17(Text19, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
                         ] }),
-                        /* @__PURE__ */ jsx15(Text17, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
+                        /* @__PURE__ */ jsx17(CliOutput, {}),
+                        showTips && /* @__PURE__ */ jsx17(Tips, {}),
+                        showNoticesInMain && showNotices && /* @__PURE__ */ jsx17(Notices, { showAll: true, border: false }),
+                        /* @__PURE__ */ jsx17(PromptInput, {}),
+                        phase === "error" && error && /* @__PURE__ */ jsx17(Box19, { marginTop: 1, children: /* @__PURE__ */ jsxs17(Text19, { color: COLORS.status.error, children: [
+                          "\u2716 ",
+                          error
+                        ] }) })
                       ] }),
-                      /* @__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
-                      ] }) })
+                      !showNoticesInMain && showNotices && /* @__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, {}))
         ]
       }
     )
@@ -1938,20 +2220,8 @@ function reconcileWorkflowState(state, workflow) {
   const definedIds = workflow.steps.map((s) => s.id).join("\n");
   if (persistedIds !== definedIds) return null;
   for (let i = 0; i < state.steps.length; i++) {
-    const record = state.steps[i];
-    const step = workflow.steps[i];
-    if (record.status === "done") {
-      const parsed = step.outputSchema.safeParse(record.output);
-      if (!parsed.success) {
-        logger.warn(
-          { stepId: step.id, issues: parsed.error.issues },
-          "reconcileWorkflowState: persisted output for a completed step no longer matches its schema; restarting the run from scratch"
-        );
-        return null;
-      }
-    }
-    record.title = step.title;
-    record.visible = step.visible;
+    state.steps[i].title = workflow.steps[i].title;
+    state.steps[i].visible = workflow.steps[i].visible;
   }
   return state;
 }
@@ -3289,9 +3559,28 @@ import { tool as tool9 } from "ai";
 import z16 from "zod";
 import { stat as stat2 } from "node:fs/promises";
 import { relative as relative5 } from "node:path";
+
+// src/lib/editor.ts
+import { spawn as spawn3 } from "node:child_process";
+function openInEditor(filePath) {
+  const { command, args } = process.platform === "darwin" ? (
+    // -t forces the default *text* editor; plain `open` on an extension
+    // with no handler (.mjs, .py) pops a "choose an application" dialog.
+    { command: "open", args: ["-t", filePath] }
+  ) : process.platform === "win32" ? { command: "cmd", args: ["/c", "start", "", filePath] } : { command: "xdg-open", args: [filePath] };
+  try {
+    const child = spawn3(command, args, { stdio: "ignore", detached: true });
+    child.on("error", () => {
+    });
+    child.unref();
+  } catch {
+  }
+}
+
+// src/lib/tools/reviewScript.ts
 function reviewScriptTool(ctx) {
   return tool9({
-    description: "Call this as soon as the ingestion script is finished and before you run it, so the user can review it.It shows the file path and returns once they have confirmed reviewing it.",
+    description: "Show a script you have written to the user and wait while they read it. Call this as soon as the script is finished and before you run it for the first time, so nothing with a side effect happens behind their back. It opens the file in their editor and returns once they have confirmed.",
     inputSchema: z16.object({
       filePath: z16.string().describe(
         "Path to the script to review, relative to the project root."
@@ -3309,6 +3598,7 @@ function reviewScriptTool(ctx) {
         return `Refused: ${filePath} is not a file. Write the script first, then review the path you wrote.`;
       }
       return serializePrompt(async () => {
+        openInEditor(resolved2.target);
         await useWizard.getState().requestUserInput({
           prompt: "",
           promptType: "enterToContinue",
@@ -3437,10 +3727,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 }) => {
@@ -3756,7 +4046,7 @@ async function runAnalysis(mode, extraInstructions = []) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.29.0-rc.118.223",
+  version: "0.29.0",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -3818,6 +4108,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"
@@ -5369,7 +5660,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;
@@ -5419,7 +5710,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();
   store.syncSteps(
     workflow.steps.map((s) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algolia/wizard",
-  "version": "0.29.0-rc.118.223",
+  "version": "0.29.0",
   "description": "Magically implement Algolia functionality in your codebase",
   "type": "module",
   "engines": {
@@ -62,6 +62,7 @@
     "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"