@algolia/wizard 0.6.0-rc.51.26 → 0.6.0-rc.51.33

package/dist/main.js

@@ -2155,11 +2155,11 @@ function writeCredentialsTool(ctx) {
 // src/lib/tools/searchFiles.ts
 import { tool as tool7 } from "ai";
 import z10 from "zod";
-import { readdir as readdir3, readFile as readFile7 } from "node:fs/promises";
+import { readdir as readdir3, readFile as readFile8 } from "node:fs/promises";
 import { join as join10 } from "node:path";
 
 // src/lib/languages.ts
-import { readdir as readdir2 } from "node:fs/promises";
+import { readdir as readdir2, readFile as readFile7 } from "node:fs/promises";
 import { existsSync as existsSync2 } from "node:fs";
 import { join as join9 } from "node:path";
 
@@ -2304,6 +2304,10 @@ var LANGUAGE_PROFILES = {
       docKey: "python"
     },
     ingestEntrypointExample: `${INGEST_DIR}/ingest.py`,
+    localSourceCaveat: {
+      unless: "requirements.txt",
+      message: "The ingestion script runs in its own environment under .algolia-wizard/, so it can install the Algolia client but not this project's packages (no requirements.txt to install from). If the script needs your database driver or ORM, add those packages to .algolia-wizard/requirements.txt and re-run the install."
+    },
     verification: [
       {
         // -x skips the venv this same directory holds; without it the check
@@ -2431,6 +2435,7 @@ var LANGUAGE_PROFILES = {
       {
         id: "maven",
         detectFiles: ["pom.xml"],
+        sdkVersionPin: "[4,5)",
         dependency: { mode: "agent-declares", file: "pom.xml" },
         installSteps: [{ argv: ["mvn", "-q", "-DskipTests", "compile"] }],
         // The main class is a wizard constant the instructions require the agent
@@ -2462,7 +2467,8 @@ var LANGUAGE_PROFILES = {
         ingest: {
           kind: "manual",
           entrypointExtensions: [".java"],
-          runCommand: "./gradlew runAlgoliaIngest"
+          runCommand: "./gradlew runAlgoliaIngest",
+          requiresBuildTask: "runAlgoliaIngest"
         }
       }
     ],
@@ -2504,7 +2510,8 @@ var LANGUAGE_PROFILES = {
         ingest: {
           kind: "manual",
           entrypointExtensions: [".kt"],
-          runCommand: "./gradlew runAlgoliaIngest"
+          runCommand: "./gradlew runAlgoliaIngest",
+          requiresBuildTask: "runAlgoliaIngest"
         }
       },
       // Kotlin/Maven is rare but real, and pom.xml is a Kotlin manifest — without
@@ -2514,6 +2521,7 @@ var LANGUAGE_PROFILES = {
       {
         id: "maven",
         detectFiles: ["pom.xml"],
+        sdkVersionPin: "[3,4)",
         dependency: { mode: "agent-declares", file: "pom.xml" },
         installSteps: [{ argv: ["mvn", "-q", "-DskipTests", "compile"] }],
         ingest: {
@@ -2798,15 +2806,15 @@ async function pickIngestionCandidates(root, confirmedNames) {
   return { candidates, confirmed: confirmed3, onDisk };
 }
 async function resolveToolchain(root, profile2) {
+  const signals = (pm) => [
+    ...pm.lockfiles ?? [],
+    ...pm.detectFiles ?? []
+  ];
   const matched = profile2.packageManagers.find(
-    (pm) => [...pm.lockfiles ?? [], ...pm.detectFiles ?? []].some(
-      (f) => existsSync2(join9(root, f))
-    )
-  );
-  const packageManager = resolveDeclaredManifest(
-    root,
-    matched ?? profile2.packageManagers[0]
+    (pm) => signals(pm).some((f) => existsSync2(join9(root, f)))
   );
+  const fallback = profile2.packageManagers.find((pm) => signals(pm).length === 0) ?? profile2.packageManagers[0];
+  const packageManager = resolveDeclaredManifest(root, matched ?? fallback);
   let { installSteps, ingest } = packageManager;
   installSteps = installSteps.map(
     (step) => isWorktreeRelativeCommand(step.argv[0]) ? { ...step, argv: withCommand(step.argv, join9(root, step.argv[0])) } : step
@@ -2847,9 +2855,27 @@ function ingestScriptDir(profile2) {
   const parts = profile2.ingestEntrypointExample.split("/");
   return parts.slice(0, -1).join("/") || ".";
 }
+function localSourceLimitation(root, profile2) {
+  const caveat = profile2.localSourceCaveat;
+  if (!caveat) return void 0;
+  return existsSync2(join9(root, caveat.unless)) ? void 0 : caveat.message;
+}
+async function missingBuildTask(root, toolchain) {
+  const { ingest, packageManager } = toolchain;
+  if (ingest.kind !== "manual" || !ingest.requiresBuildTask) return void 0;
+  if (packageManager.dependency.mode !== "agent-declares") return void 0;
+  const buildFile = join9(root, packageManager.dependency.file);
+  const contents = await readFile7(buildFile, "utf8").catch(() => void 0);
+  if (contents === void 0) return void 0;
+  return contents.includes(ingest.requiresBuildTask) ? void 0 : ingest.requiresBuildTask;
+}
+function sdkVersionPin(profile2, packageManager) {
+  return packageManager.sdkVersionPin ?? profile2.sdk.versionPin;
+}
 function dependencyInstruction(toolchain) {
   const { profile: profile2, packageManager } = toolchain;
-  const { packageName, versionPin } = profile2.sdk;
+  const { packageName } = profile2.sdk;
+  const versionPin = sdkVersionPin(profile2, packageManager);
   const also = profile2.sdk.alsoRequires ? ` ${profile2.sdk.alsoRequires}` : "";
   switch (packageManager.dependency.mode) {
     case "wizard-installs":
@@ -2900,7 +2926,7 @@ function searchFilesTool(ctx) {
       for (const file of await walkFiles(resolved.target)) {
         let content;
         try {
-          content = await readFile7(file, "utf8");
+          content = await readFile8(file, "utf8");
         } catch {
           continue;
         }
@@ -3467,7 +3493,7 @@ async function runAnalysis(mode, extraInstructions = []) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.6.0-rc.51.26",
+  version: "0.6.0-rc.51.33",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -3489,7 +3515,7 @@ var package_default = {
     prepare: "husky",
     prepublishOnly: "pnpm build",
     reset: "tsx ./scripts/reset-state.ts",
-    "test:fixtures": "touch .env && tsx --env-file=.env ./fixtures/run-fixtures.ts",
+    "test:toolchains": "tsx ./scripts/verify-toolchains.ts",
     "test:tools": "tsx ./tool-evals/toolEval.ts",
     test: "vitest",
     typecheck: "tsc --noEmit -p tsconfig.json"
@@ -3977,7 +4003,7 @@ import z24 from "zod";
 // src/lib/worktree.ts
 import { execFile } from "node:child_process";
 import { existsSync as existsSync4 } from "node:fs";
-import { copyFile, mkdir as mkdir6, readdir as readdir4, readFile as readFile8, stat as stat2, writeFile as writeFile6 } from "node:fs/promises";
+import { copyFile, mkdir as mkdir6, readdir as readdir4, readFile as readFile9, stat as stat2, writeFile as writeFile6 } from "node:fs/promises";
 import {
   basename as basename2,
   dirname as dirname7,
@@ -4188,7 +4214,7 @@ async function writeSearchEnvValues(worktreePath, vars) {
   const target = join12(worktreePath, ".env");
   let existing = "";
   try {
-    existing = await readFile8(target, "utf8");
+    existing = await readFile9(target, "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") throw err;
   }
@@ -4465,7 +4491,7 @@ function ingestionInstructions(input) {
   const { ingestionProfile: profile2, toolchain } = input;
   const { ingest } = toolchain;
   const extensions = ingest.entrypointExtensions.join(", ");
-  const runInstruction = ingest.kind === "auto" ? `Return "entrypoint": the script path relative to the worktree root (e.g. "${profile2.ingestEntrypointExample}"), ending in one of ${extensions}. The wizard runs it with \`${describeIngestCommand(ingest, profile2.ingestEntrypointExample)}\`, so it must be a plain path with no flags or arguments and must run as-is under that command.` : `Return "entrypoint": the script path relative to the worktree root (e.g. "${profile2.ingestEntrypointExample}"), ending in one of ${extensions}. The wizard does NOT run ${profile2.displayName} ${toolchain.packageManager.id} projects itself \u2014 it tells the developer to run \`${describeIngestCommand(ingest, profile2.ingestEntrypointExample)}\`, so also add whatever build configuration that command needs.`;
+  const runInstruction = ingest.kind === "auto" ? `Return "entrypoint": the script path relative to the worktree root (e.g. "${profile2.ingestEntrypointExample}"), ending in one of ${extensions}. The wizard runs it with \`${describeIngestCommand(ingest, profile2.ingestEntrypointExample)}\`, so it must be a plain path with no flags or arguments and must run as-is under that command.` : `Return "entrypoint": the script path relative to the worktree root (e.g. "${profile2.ingestEntrypointExample}"), ending in one of ${extensions}. The wizard does NOT run ${profile2.displayName} ${toolchain.packageManager.id} projects itself \u2014 it tells the developer to run \`${describeIngestCommand(ingest, profile2.ingestEntrypointExample)}\`, so also add whatever build configuration that command needs${ingest.kind === "manual" && ingest.requiresBuildTask ? `, including a "${ingest.requiresBuildTask}" task in "${toolchain.packageManager.dependency.mode === "agent-declares" ? toolchain.packageManager.dependency.file : "the build file"}" that runs the script` : ""}.`;
   return [
     ...input.confirmed && input.confirmed.length ? [
       `Write the ingestion script in ${profile2.displayName}, at "${ingestScriptDir(profile2)}/" in the repo.`,
@@ -4894,6 +4920,19 @@ ${run.output}` : status;
           commandMessages.push(
             `The wizard does not run ${ingestionProfile.displayName} ${toolchain.packageManager.id} projects \u2014 run the command above yourself to ingest.`
           );
+          const missingTask = await missingBuildTask(worktree, toolchain);
+          if (missingTask) {
+            const warning = `\u26A0\uFE0F The command above needs a "${missingTask}" task, which is not in ${toolchain.packageManager.dependency.mode === "agent-declares" ? toolchain.packageManager.dependency.file : "the build file"} \u2014 add it before running, or run the script through your IDE instead.`;
+            commandMessages.push(warning);
+            summaries.push(warning);
+          }
+        }
+      }
+      if (ingestionSource === "local") {
+        const limitation = localSourceLimitation(worktree, ingestionProfile);
+        if (limitation) {
+          commandMessages.push(`\u26A0\uFE0F ${limitation}`);
+          summaries.push(`\u26A0\uFE0F ${limitation}`);
         }
       }
       await ctx.requestUserInput({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algolia/wizard",
-  "version": "0.6.0-rc.51.26",
+  "version": "0.6.0-rc.51.33",
   "description": "Magically implement Algolia functionality in your codebase",
   "type": "module",
   "engines": {
@@ -22,7 +22,7 @@
     "prepare": "husky",
     "prepublishOnly": "pnpm build",
     "reset": "tsx ./scripts/reset-state.ts",
-    "test:fixtures": "touch .env && tsx --env-file=.env ./fixtures/run-fixtures.ts",
+    "test:toolchains": "tsx ./scripts/verify-toolchains.ts",
     "test:tools": "tsx ./tool-evals/toolEval.ts",
     "test": "vitest",
     "typecheck": "tsc --noEmit -p tsconfig.json"