@algolia/wizard 0.5.0-rc.45.15 → 0.5.0-rc.49.16

package/dist/main.js

@@ -4,7 +4,7 @@
 import { render } from "ink";
 
 // src/ui/App.tsx
-import { Box as Box13, Text as Text13, useApp, useInput as useInput6, useWindowSize as useWindowSize7 } from "ink";
+import { Box as Box13, Text as Text13, useApp, useInput as useInput6, useWindowSize as useWindowSize6 } from "ink";
 
 // src/core/store.ts
 import { create } from "zustand";
@@ -525,20 +525,10 @@ function NextAction({
 }
 
 // src/ui/SelectPrompt.tsx
-import { Box as Box4, Text as Text4, measureElement as measureElement2, useInput, useWindowSize as useWindowSize3 } from "ink";
-import { useLayoutEffect, useRef as useRef2, useState as useState3 } from "react";
+import { Box as Box4, Text as Text4, useInput } from "ink";
+import { useState as useState3 } from "react";
 import { jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
 var CANCEL = "cancel";
-var ARROW_WIDTH = 4;
-var COLUMN_GAP = 2;
-var BAR_PADDING = 2;
-function fittedWidth(node, columns) {
-  let left = 0;
-  for (let n = node; n; n = n.parentNode) {
-    left += n.yogaNode?.getComputedLeft() ?? 0;
-  }
-  return Math.max(Math.min(measureElement2(node).width, columns - left), 0);
-}
 function SelectPrompt({
   options,
   onSelect,
@@ -563,29 +553,12 @@ function SelectPrompt({
   if (rows.length > 1) hints.push({ key: "[\u2191] [\u2193]", label: "move" });
   if (multi) hints.push({ key: "[space]", label: "select" });
   hints.push({ key: "[enter]", label: "confirm" });
-  const containerRef = useRef2(null);
-  const { columns } = useWindowSize3();
-  const [width, setWidth] = useState3(columns);
-  useLayoutEffect(() => {
-    if (containerRef.current) {
-      setWidth(fittedWidth(containerRef.current, columns));
-    }
-  }, [columns]);
-  const inner = Math.max(width - BAR_PADDING, 0);
-  const labelWidth = Math.min(
-    ARROW_WIDTH + (multi ? 2 : 0) + Math.max(0, ...rows.map((opt) => opt.length)) + COLUMN_GAP,
-    inner
-  );
-  const badgeWidth = Math.max(
+  const labelColWidth = 6 + Math.max(0, ...rows.map((opt) => opt.length));
+  const secondaryWidth = Math.max(
     0,
-    ...rows.map((_, i) => {
-      const s = secondary?.[i];
-      return s?.kind === "badge" ? s.value.length : 0;
-    })
+    ...rows.map((_, i) => secondary?.[i]?.value.length ?? 0)
   );
-  const barWidth = Math.min(labelWidth + badgeWidth + BAR_PADDING, width);
-  const barLabelWidth = Math.max(barWidth - BAR_PADDING - badgeWidth, 0);
-  const textWidth = inner - labelWidth;
+  const rowWidth = labelColWidth + (secondaryWidth ? secondaryWidth + 2 : 0) + 6;
   useInput((input, key) => {
     if (rows.length === 0) return;
     if (key.upArrow || input === "k") {
@@ -609,7 +582,7 @@ function SelectPrompt({
       }
     }
   });
-  return /* @__PURE__ */ jsx4(Box4, { ref: containerRef, flexGrow: 1, children: /* @__PURE__ */ jsxs3(Box4, { flexDirection: "column", gap: 1, width, children: [
+  return /* @__PURE__ */ jsxs3(Box4, { flexDirection: "column", gap: 1, children: [
     error && /* @__PURE__ */ jsx4(Text4, { color: COLORS.danger, children: error }),
     messages?.map((m, i) => /* @__PURE__ */ jsx4(Text4, { color: COLORS.muted, children: m }, `msg-${i}`)),
     table && /* @__PURE__ */ jsx4(Table, { columns: table.columns, rows: table.rows }),
@@ -623,36 +596,29 @@ function SelectPrompt({
       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__ */ jsxs3(Text4, { color: labelColor, wrap: "truncate", children: [
+      const label = /* @__PURE__ */ jsxs3(Text4, { color: labelColor, children: [
         highlighted ? "\u276F   " : "    ",
         bullet,
         option
       ] });
-      const isText = sec?.kind === "text";
       return /* @__PURE__ */ jsxs3(
         Box4,
         {
-          width: isText ? "100%" : barWidth,
+          width: rowWidth,
           paddingX: 1,
           paddingY: 1,
           backgroundColor: highlighted ? COLORS.highlight.bg : void 0,
           children: [
-            /* @__PURE__ */ jsx4(Box4, { width: isText ? labelWidth : barLabelWidth, children: label }),
-            isText && textWidth > 0 && /* @__PURE__ */ jsx4(Box4, { width: textWidth, children: /* @__PURE__ */ jsx4(
-              Text4,
-              {
-                wrap: "truncate",
-                color: highlighted ? COLORS.primary : COLORS.muted,
-                children: sec.value
-              }
-            ) }),
-            sec?.kind === "badge" && /* @__PURE__ */ jsx4(Box4, { width: badgeWidth, justifyContent: "flex-end", children: /* @__PURE__ */ jsx4(Text4, { color: COLORS.badge, wrap: "truncate", children: sec.value }) })
+            sec?.kind === "text" ? /* @__PURE__ */ jsx4(Box4, { width: labelColWidth, flexShrink: 0, children: label }) : label,
+            sec?.kind === "text" && /* @__PURE__ */ jsx4(Text4, { color: highlighted ? COLORS.primary : COLORS.muted, children: sec.value }),
+            /* @__PURE__ */ jsx4(Box4, { flexGrow: 1 }),
+            sec?.kind === "badge" && /* @__PURE__ */ jsx4(Text4, { color: COLORS.badge, children: sec.value })
           ]
         },
         `row-${i}`
       );
     }) }),
-    /* @__PURE__ */ jsx4(Text4, { children: hints.map(({ key, label }, i) => /* @__PURE__ */ jsxs3(Text4, { children: [
+    /* @__PURE__ */ jsx4(Box4, { children: hints.map(({ key, label }, i) => /* @__PURE__ */ jsxs3(Text4, { children: [
       i > 0 ? "   " : "",
       /* @__PURE__ */ jsx4(Text4, { color: COLORS.primary, children: key }),
       /* @__PURE__ */ jsxs3(Text4, { color: COLORS.dim, children: [
@@ -660,7 +626,7 @@ function SelectPrompt({
         label
       ] })
     ] }, label)) })
-  ] }) });
+  ] });
 }
 
 // src/ui/PromptInput.tsx
@@ -783,7 +749,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 Box6, Spacer, Text as Text6, useInput as useInput3, useWindowSize as useWindowSize4 } from "ink";
+import { Box as Box6, Spacer, Text as Text6, useInput as useInput3, useWindowSize as useWindowSize3 } from "ink";
 
 // src/ui/copy/welcome.ts
 var sidebarItems = [
@@ -831,7 +797,7 @@ function SidebarItem({
 function Welcome() {
   const confirmStart = useWizard((s) => s.confirmStart);
   const openLearnMore = useWizard((s) => s.openLearnMore);
-  const { rows } = useWindowSize4();
+  const { rows } = useWindowSize3();
   useInput3((input) => {
     if (input === " ") confirmStart();
     else if (input === "i") openLearnMore();
@@ -899,7 +865,7 @@ function Welcome() {
 
 // src/ui/LearnMore.tsx
 import { Fragment as Fragment2 } from "react";
-import { Box as Box7, Text as Text7, useInput as useInput4, useWindowSize as useWindowSize5 } from "ink";
+import { Box as Box7, Text as Text7, useInput as useInput4, useWindowSize as useWindowSize4 } 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.";
@@ -963,7 +929,7 @@ function NeverLine({
 function LearnMore() {
   const confirmStart = useWizard((s) => s.confirmStart);
   const backToHome = useWizard((s) => s.backToHome);
-  const { columns } = useWindowSize5();
+  const { columns } = useWindowSize4();
   const dividerWidth = Math.max(0, columns - PADDING_X * 2);
   useInput4((input, key) => {
     if (key.escape) backToHome();
@@ -1176,8 +1142,8 @@ function Ribbon() {
 import { useState as useState6 } from "react";
 
 // src/ui/Logs.tsx
-import { useLayoutEffect as useLayoutEffect2, useRef as useRef3, useState as useState5 } from "react";
-import { Box as Box12, Text as Text12, measureElement as measureElement3, useInput as useInput5, useWindowSize as useWindowSize6 } from "ink";
+import { useLayoutEffect, useRef as useRef2, useState as useState5 } from "react";
+import { Box as Box12, Text as Text12, measureElement as measureElement2, useInput as useInput5, useWindowSize as useWindowSize5 } from "ink";
 import { jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
 var KIND_COLOR = {
   tool: COLORS.primary,
@@ -1208,15 +1174,15 @@ function formatTimestamp(ms) {
 }
 function Logs() {
   const logs = useWizard((s) => s.logs);
-  const { rows, columns } = useWindowSize6();
-  const viewportRef = useRef3(null);
+  const { rows, columns } = useWindowSize5();
+  const viewportRef = useRef2(null);
   const [viewportHeight, setViewportHeight] = useState5(0);
   const [viewportWidth, setViewportWidth] = useState5(0);
   const [scrollOffset, setScrollOffset] = useState5(0);
-  const prevMaxOffsetRef = useRef3(0);
-  useLayoutEffect2(() => {
+  const prevMaxOffsetRef = useRef2(0);
+  useLayoutEffect(() => {
     if (!viewportRef.current) return;
-    const { width, height } = measureElement3(viewportRef.current);
+    const { width, height } = measureElement2(viewportRef.current);
     setViewportHeight(height);
     setViewportWidth(width);
   }, [rows, columns, logs.length === 0]);
@@ -1231,7 +1197,7 @@ function Logs() {
   }
   const capacityAtBottom = logs.length > viewportHeight ? Math.max(viewportHeight - 1, 0) : viewportHeight;
   const maxOffset = Math.max(logs.length - capacityAtBottom, 0);
-  useLayoutEffect2(() => {
+  useLayoutEffect(() => {
     const wasAtBottom = scrollOffset >= prevMaxOffsetRef.current;
     prevMaxOffsetRef.current = maxOffset;
     setScrollOffset((o) => wasAtBottom ? maxOffset : Math.min(o, maxOffset));
@@ -1304,7 +1270,7 @@ import { jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
 function App() {
   const { phase, error, homeScreen, currentStepIndex, steps, inputReq } = useWizard();
   const { exit } = useApp();
-  const { columns, rows } = useWindowSize7();
+  const { columns, rows } = useWindowSize6();
   const [showLogs, setShowLogs] = useState6(false);
   const finished = phase === "done" || phase === "error";
   const currentStep = steps[currentStepIndex];
@@ -1358,28 +1324,15 @@ function App() {
             width: "100%",
             justifyContent: "space-between",
             children: [
-              showLogs ? /* @__PURE__ */ jsx13(Logs, {}) : (
-                /* Fill the width beside the sidebar; row layout only (would grow vertically when stacked). */
-                /* @__PURE__ */ jsxs12(
-                  Box13,
-                  {
-                    flexDirection: "column",
-                    paddingX: 4,
-                    paddingY: 2,
-                    width: showSidebar ? 70 : "100%",
-                    flexGrow: showSidebar ? 1 : 0,
-                    children: [
-                      /* @__PURE__ */ jsx13(Notices, {}),
-                      /* @__PURE__ */ jsx13(PromptInput, {}),
-                      phase === "running" && showSidebar && /* @__PURE__ */ jsx13(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx13(CurrentStep, {}) }),
-                      phase === "error" && error && /* @__PURE__ */ jsx13(Box13, { marginTop: 1, children: /* @__PURE__ */ jsxs12(Text13, { color: COLORS.status.error, children: [
-                        "\u2716 ",
-                        error
-                      ] }) })
-                    ]
-                  }
-                )
-              ),
+              showLogs ? /* @__PURE__ */ jsx13(Logs, {}) : /* @__PURE__ */ jsxs12(Box13, { flexDirection: "column", paddingX: 4, paddingY: 2, width: 70, children: [
+                /* @__PURE__ */ jsx13(Notices, {}),
+                /* @__PURE__ */ jsx13(PromptInput, {}),
+                phase === "running" && showSidebar && /* @__PURE__ */ jsx13(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx13(CurrentStep, {}) }),
+                phase === "error" && error && /* @__PURE__ */ jsx13(Box13, { marginTop: 1, children: /* @__PURE__ */ jsxs12(Text13, { color: COLORS.status.error, children: [
+                  "\u2716 ",
+                  error
+                ] }) })
+              ] }),
               showSidebar ? /* @__PURE__ */ jsx13(Sidebar, {}) : /* @__PURE__ */ jsx13(Ribbon, {})
             ]
           }
@@ -1400,7 +1353,8 @@ var configFile = () => join5(stateDir(), "config.json");
 var DEFAULT_CONFIG = {
   version: 1,
   aiConsent: false,
-  workflowsRun: []
+  workflowsRun: [],
+  searchApiKeys: {}
 };
 async function loadConfig() {
   try {
@@ -1419,6 +1373,38 @@ async function recordWorkflowRun(workflowId, completedAt) {
   config.workflowsRun.push({ workflowId, completedAt });
   await saveConfig(config);
 }
+function isStoredSearchKey(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const { appId, key } = value;
+  return typeof appId === "string" && !!appId && typeof key === "string" && !!key;
+}
+function storedSearchKeys(config) {
+  const stored = config.searchApiKeys;
+  if (typeof stored !== "object" || stored === null || Array.isArray(stored)) {
+    return {};
+  }
+  return stored;
+}
+async function getStoredSearchKey(index, appId) {
+  const entry = storedSearchKeys(await loadConfig())[index];
+  if (!isStoredSearchKey(entry) || entry.appId !== appId) return void 0;
+  return entry.key;
+}
+async function storeSearchKey(index, appId, key) {
+  const config = await loadConfig();
+  config.searchApiKeys = {
+    ...storedSearchKeys(config),
+    [index]: { appId, key }
+  };
+  await saveConfig(config);
+}
+async function forgetSearchKey(index) {
+  const config = await loadConfig();
+  const remaining = { ...storedSearchKeys(config) };
+  delete remaining[index];
+  config.searchApiKeys = remaining;
+  await saveConfig(config);
+}
 
 // src/lib/telemetry.ts
 function isTelemetryEnabled() {
@@ -2695,7 +2681,7 @@ async function runAnalysis(mode, extraInstructions = []) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.5.0-rc.45.15",
+  version: "0.5.0-rc.49.16",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -2743,7 +2729,7 @@ var package_default = {
   dependencies: {
     "@ai-sdk/anthropic": "^3.0.81",
     "@ai-sdk/openai-compatible": "^2.0.47",
-    "@algolia/cli": "^5.11.0",
+    "@algolia/cli": "^5.15.0",
     "@hono/node-server": "^2.0.10",
     "@mishieck/ink-titled-box": "^0.4.2",
     "@segment/analytics-node": "^3.1.0",
@@ -3301,6 +3287,23 @@ async function copyUploadIntoWorktree(repoRoot, worktreePath, ingestDir, sourceP
 function hasEnvVar(content, name) {
   return new RegExp(`^(\\s*(?:export\\s+)?${name})\\s*=`, "m").test(content);
 }
+async function readEnvVar(worktreePath, name) {
+  let content;
+  try {
+    content = await readFile8(join10(worktreePath, ".env"), "utf8");
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err;
+    return void 0;
+  }
+  const match = new RegExp(
+    `^[ \\t]*(?:export[ \\t]+)?${name}[ \\t]*=[ \\t]*(.*)$`,
+    "m"
+  ).exec(content);
+  if (!match) return void 0;
+  const value = match[1].trim().replace(/^(['"])(.*)\1$/, "$2").trim();
+  if (!value || value.startsWith("<")) return void 0;
+  return value;
+}
 async function writeSearchEnvValues(worktreePath, vars) {
   const target = join10(worktreePath, ".env");
   let existing = "";
@@ -3375,50 +3378,72 @@ async function confirmDirtyWorkingTree(ctx, repoRoot) {
 
 // src/lib/algoliaApiKey.ts
 import { z as z23 } from "zod";
-var SAFE_ACLS = /* @__PURE__ */ new Set(["search", "browse", "listIndexes"]);
-var apiKeySchema = z23.object({
-  value: z23.string().min(1),
-  acl: z23.array(z23.string()).default([]),
-  indexes: z23.array(z23.string()).default([])
-});
-var apiKeyListSchema = z23.object({
-  items: z23.array(apiKeySchema).optional(),
-  keys: z23.array(apiKeySchema).optional()
-}).transform((o) => o.items ?? o.keys ?? []);
 var createdKeySchema = z23.object({
   key: z23.string().min(1).optional(),
   value: z23.string().min(1).optional()
-});
-function canReuse(key, index) {
-  return key.acl.includes("search") && key.acl.every((acl) => SAFE_ACLS.has(acl)) && (key.indexes.length === 0 || key.indexes.includes("*") || key.indexes.includes(index));
-}
-async function createSearchKey(index) {
+}).transform((o) => o.key ?? o.value);
+async function createSearchOnlyKey(index) {
+  logger.info({ index }, "creating a search-only API key");
   const stdout = await runAlgoliaCli([
     "apikeys",
     "create",
+    "--acl",
+    "search",
     "--indices",
     index,
-    "--acl",
-    "search,browse",
     "--description",
-    `wizard search-only key for ${index}`,
+    `Algolia Wizard search-only key for ${index}`,
     "-o",
     "json"
   ]);
-  const { key, value } = createdKeySchema.parse(JSON.parse(stdout));
-  const created = key ?? value;
+  let payload;
+  try {
+    payload = JSON.parse(stdout);
+  } catch {
+    throw new Error("apikeys create returned output that is not valid JSON");
+  }
+  const created = createdKeySchema.parse(payload);
   if (!created) throw new Error("apikeys create returned no key value");
   return created;
 }
-async function resolveSearchOnlyKey(index) {
-  const stdout = await runAlgoliaCli(["apikeys", "list", "-o", "json"]);
-  const existing = apiKeyListSchema.parse(JSON.parse(stdout)).find((key) => canReuse(key, index))?.value;
-  if (existing) {
-    logger.info({ index }, "reusing existing search-only API key");
-    return existing;
+async function apiKeyExists(key) {
+  try {
+    await runAlgoliaCli(["apikeys", "get", key, "-o", "json"]);
+    return true;
+  } catch (err) {
+    return !/does not exist|not found|404/i.test(err.message);
+  }
+}
+async function resolveSearchOnlyKey(index, appId, envKey) {
+  if (envKey) {
+    await recordSearchKey(index, appId, envKey);
+    return { key: envKey, source: "env" };
+  }
+  const stored = await getStoredSearchKey(index, appId);
+  if (stored) {
+    if (await apiKeyExists(stored)) {
+      logger.info({ index, appId }, "reusing the stored search-only API key");
+      return { key: stored, source: "config" };
+    }
+    logger.warn(
+      { index, appId },
+      "the stored search-only API key no longer exists; creating a replacement"
+    );
+    await forgetSearchKey(index);
+  }
+  const key = await createSearchOnlyKey(index);
+  await recordSearchKey(index, appId, key);
+  return { key, source: "created" };
+}
+async function recordSearchKey(index, appId, key) {
+  try {
+    await storeSearchKey(index, appId, key);
+  } catch (err) {
+    logger.warn(
+      { err: err.message, index },
+      "could not record the search-only API key; a later run may create another"
+    );
   }
-  logger.info({ index }, "no reusable search-only key found; creating one");
-  return createSearchKey(index);
 }
 
 // src/lib/algoliaDocs.ts
@@ -3573,15 +3598,22 @@ function publicEnvPrefix(language) {
   }
   return "PUBLIC_";
 }
+var APP_ID_VAR_SUFFIX = "ALGOLIA_APP_ID";
+var SEARCH_KEY_VAR_SUFFIX = "ALGOLIA_SEARCH_API_KEY";
+function appIdVar(language) {
+  return `${publicEnvPrefix(language)}${APP_ID_VAR_SUFFIX}`;
+}
+function searchKeyVar(language) {
+  return `${publicEnvPrefix(language)}${SEARCH_KEY_VAR_SUFFIX}`;
+}
 function searchEnvVars(language, appId, searchKey) {
-  const prefix = publicEnvPrefix(language);
   return [
     {
-      name: `${prefix}ALGOLIA_APP_ID`,
+      name: appIdVar(language),
       value: appId ?? "<your-algolia-app-id>"
     },
     {
-      name: `${prefix}ALGOLIA_SEARCH_API_KEY`,
+      name: searchKeyVar(language),
       value: searchKey ?? "<your-algolia-search-only-api-key>"
     }
   ];
@@ -3643,15 +3675,9 @@ function searchInstructions(input) {
     "Follow the Algolia JS SDK reference below for client setup and InstantSearch wiring; prefer it over prior knowledge:",
     doc,
     `Add the search UI at ${input.searchLocation ? `"${input.searchLocation}"` : "the best shared, always-rendered layout location (e.g. a header/nav component)"} so it is reachable across the app \u2014 at least a working SearchBox and Hits against the "${input.targetIndex}" index.`,
-    "Read the App ID and a search-only API key from public env vars; never hardcode them. A search-only key is safe to expose client-side.",
-    // appId always resolves (loadActiveProfile throws otherwise); only the
-    // search-only key is best-effort and can fall back to a placeholder.
-    `Values: App ID "${input.appId}", search-only key ${input.searchKey ? `"${input.searchKey}"` : "(placeholder for the developer to fill in)"}.`,
-    // Names are fixed, not the agent's to rename: the wizard writes the
-    // resolved app id / search-only key into ".env" under these exact names
-    // right after this step, so a renamed prefix here would leave the code
-    // reading a var the wizard never wrote.
+    `Add Algolia App ID "${input.appId}", search-only key ${input.searchKey ? `"${input.searchKey}"` : "(placeholder for the developer to fill in)"}.`,
     `Use exactly these public env var names in the code: ${input.searchEnvVars.map(({ name }) => name).join(", ")}.`,
+    "Read the App ID and a search-only API key from public env vars; never hardcode them. A search-only key is safe to expose client-side.",
     'Add any Algolia/InstantSearch packages you import to package.json "dependencies" with a valid version range; the wizard installs them in the worktree after you finish.',
     "The summary should be extremely concise; do not mention env var setup or manual testing steps \u2014 the wizard writes the resolved credentials to .env and reports that separately."
   ];
@@ -3804,17 +3830,43 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES, existingWo
   let searchKey;
   if (useCases.includes("search")) {
     appId = (await loadActiveProfile()).appId;
-    try {
-      searchKey = await resolveSearchOnlyKey(targetIndex);
-    } catch (err) {
-      logger.warn(
-        { err: err.message },
-        "implement: could not resolve a search-only API key; the agent will scaffold a placeholder"
-      );
-    }
   }
   const worktree = existingWorktreePath ?? (await createWorktree(repoRoot)).path;
   try {
+    const searchKeyNotices = [];
+    let searchKeyError;
+    if (useCases.includes("search") && appId) {
+      const envAppId = await readEnvVar(worktree, appIdVar(language));
+      const envKey = envAppId === appId ? await readEnvVar(worktree, searchKeyVar(language)) : void 0;
+      if (envAppId && envAppId !== appId) {
+        searchKeyNotices.push(
+          `\u26A0\uFE0F .env already sets ${appIdVar(language)}=${envAppId}, but the active Algolia application is ${appId}. The wizard left those values alone \u2014 update ${appIdVar(language)} and ${searchKeyVar(language)} by hand, or searches will fail.`
+        );
+        logger.warn(
+          { envAppId, appId },
+          "implement: .env holds credentials for a different Algolia application; not reusing its search key"
+        );
+      }
+      try {
+        const resolved = await resolveSearchOnlyKey(targetIndex, appId, envKey);
+        searchKey = resolved.key;
+        if (resolved.source === "created") {
+          searchKeyNotices.push(
+            `Created a new search-only Algolia API key for the "${targetIndex}" index in app ${appId} \u2014 safe to expose in frontend code. Delete it in the Algolia dashboard when you no longer need it; the wizard can't.`
+          );
+        } else {
+          searchKeyNotices.push(
+            `Reused the existing search-only Algolia API key for the "${targetIndex}" index in app ${appId}.`
+          );
+        }
+      } catch (err) {
+        searchKeyError = err.message;
+        logger.warn(
+          { err: searchKeyError },
+          "implement: could not provision a search-only API key; the agent will scaffold a placeholder"
+        );
+      }
+    }
     process.chdir(worktree);
     let uploadFilePath;
     let uploadWarning;
@@ -3854,6 +3906,7 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES, existingWo
     };
     const summaries = [];
     if (uploadWarning) summaries.push(uploadWarning);
+    summaries.push(...searchKeyNotices);
     let agentRuns = 0;
     let ingestRuntime;
     let ingestEntrypoint;
@@ -4063,7 +4116,9 @@ ${run.output}` : status;
       );
       if (unresolvedSearchEnvVars.length > 0) {
         summaries.push(
-          `Could not resolve a value for ${unresolvedSearchEnvVars.map((v) => v.name).join(", ")} \u2014 fill it in manually in .env.`
+          `Could not resolve a value for ${unresolvedSearchEnvVars.map((v) => v.name).join(", ")} \u2014 fill it in manually in .env.` + // The reason is the actionable half ("key has no manage rights" tells
+          // the user what to fix); without it the line is a dead end.
+          (searchKeyError ? ` Reason: ${searchKeyError}` : "")
         );
       }
     } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algolia/wizard",
-  "version": "0.5.0-rc.45.15",
+  "version": "0.5.0-rc.49.16",
   "description": "Magically implement Algolia functionality in your codebase",
   "type": "module",
   "engines": {
@@ -48,7 +48,7 @@
   "dependencies": {
     "@ai-sdk/anthropic": "^3.0.81",
     "@ai-sdk/openai-compatible": "^2.0.47",
-    "@algolia/cli": "^5.11.0",
+    "@algolia/cli": "^5.15.0",
     "@hono/node-server": "^2.0.10",
     "@mishieck/ink-titled-box": "^0.4.2",
     "@segment/analytics-node": "^3.1.0",