@algolia/wizard 0.8.0-rc.60.48 → 0.8.0-rc.63.52

package/dist/main.js

@@ -907,7 +907,7 @@ var accessItems = [
   {
     tag: "READ",
     title: "Project files",
-    description: "reads your dependency manifests (package.json, pyproject.toml\u2026), configs & source to detect your stack. Read-only; nothing is uploaded."
+    description: "reads your dependency manifests (package.json, pyproject.toml, Gemfile, go.mod\u2026), configs & source to detect your stack. Read-only; nothing is uploaded."
   },
   {
     tag: "WRITE",
@@ -2206,6 +2206,7 @@ function shellQuote(value) {
 // src/lib/languages.ts
 var ENTRYPOINT_TOKEN = "{entrypoint}";
 var INGEST_DIR = ".algolia-wizard";
+var VISIBLE_INGEST_DIR = "algolia-wizard";
 var PY_VENV = `${INGEST_DIR}/.venv`;
 var PY_VENV_PYTHON = `${PY_VENV}/bin/python`;
 var PY_REQUIREMENTS = `${INGEST_DIR}/requirements.txt`;
@@ -2329,6 +2330,105 @@ var LANGUAGE_PROFILES = {
       "build",
       "htmlcov"
     ]
+  },
+  ruby: {
+    id: "ruby",
+    displayName: "Ruby",
+    aliases: ["ruby", "rb", "rails", "ruby on rails", "rubyonrails"],
+    manifests: ["Gemfile", "*.gemspec"],
+    packageManagers: [
+      {
+        id: "bundler",
+        dependency: { mode: "agent-declares", file: "Gemfile" },
+        installSteps: [{ argv: ["bundle", "install"] }],
+        ingest: {
+          kind: "auto",
+          argv: ["bundle", "exec", "ruby", ENTRYPOINT_TOKEN],
+          entrypointExtensions: [".rb"]
+        }
+      }
+    ],
+    sdk: { packageName: "algolia", versionPin: "~> 3.0", docKey: "ruby" },
+    ingestEntrypointExample: `${INGEST_DIR}/ingest.rb`,
+    // Ruby has no directory-level syntax check (`ruby -c` is one file at a
+    // time), so verification relies on the agent's own review here.
+    verification: [],
+    envReadInstruction: "Read them from `ENV.fetch('NAME')`.",
+    skipDirs: ["vendor", "tmp", "log", "coverage"]
+  },
+  php: {
+    id: "php",
+    displayName: "PHP",
+    aliases: ["php", "laravel", "symfony"],
+    manifests: ["composer.json"],
+    packageManagers: [
+      {
+        id: "composer",
+        // `composer require` both declares and installs, and unlike editing
+        // composer.json by hand it can't leave composer.lock out of date (which
+        // makes a later `composer install` refuse to run).
+        dependency: { mode: "wizard-installs" },
+        installSteps: [
+          {
+            argv: [
+              "composer",
+              "require",
+              "algolia/algoliasearch-client-php:^4",
+              "--no-interaction",
+              // Repo post-install scripts are the project's code, not ours to
+              // trigger; Laravel's package:discover also fails in a bare tree.
+              "--no-scripts"
+            ]
+          }
+        ],
+        ingest: {
+          kind: "auto",
+          argv: ["php", ENTRYPOINT_TOKEN],
+          entrypointExtensions: [".php"]
+        }
+      }
+    ],
+    sdk: {
+      packageName: "algolia/algoliasearch-client-php",
+      versionPin: "^4",
+      docKey: "php"
+    },
+    ingestEntrypointExample: `${INGEST_DIR}/ingest.php`,
+    verification: [],
+    envReadInstruction: "Read them from `getenv('NAME')`.",
+    skipDirs: ["vendor", "node_modules"]
+  },
+  go: {
+    id: "go",
+    displayName: "Go",
+    aliases: ["go", "golang"],
+    manifests: ["go.mod"],
+    packageManagers: [
+      {
+        id: "gomod",
+        // Imports in the generated file are the declaration; `go mod tidy`
+        // resolves and fetches them — which only works because the script lives
+        // outside INGEST_DIR (see VISIBLE_INGEST_DIR).
+        dependency: { mode: "code-imports" },
+        installSteps: [{ argv: ["go", "mod", "tidy"] }],
+        ingest: {
+          kind: "auto",
+          argv: ["go", "run", ENTRYPOINT_TOKEN],
+          entrypointExtensions: [".go"]
+        }
+      }
+    ],
+    sdk: {
+      packageName: "github.com/algolia/algoliasearch-client-go/v4",
+      versionPin: "v4",
+      docKey: "go"
+    },
+    ingestEntrypointExample: `${VISIBLE_INGEST_DIR}/ingest.go`,
+    verification: [
+      { label: "go vet", argv: ["go", "vet", "./..."], requiresFile: "go.mod" }
+    ],
+    envReadInstruction: "Read them from `os.Getenv`.",
+    skipDirs: ["vendor", "bin"]
   }
 };
 var DEFAULT_LANGUAGE_ID = "javascript";
@@ -3011,7 +3111,7 @@ var detectLanguageSchema = z16.object({
 var detectLanguage = () => runAgent({
   instructions: [
     "Analyze the codebase and determine the programming languages and frameworks used",
-    "Start from the dependency manifests: package.json, pyproject.toml, requirements.txt.",
+    "Start from the dependency manifests: package.json, pyproject.toml, requirements.txt, Gemfile, composer.json, go.mod.",
     "List the language that owns the backend/data code first \u2014 that is the one an ingestion script will be written in.",
     "If a superset language is found, exclude the subset language. TS-over-JS.",
     "If a meta-framework is used, exclude the framework. Next-over-React.",
@@ -3064,7 +3164,7 @@ var MODE_CONFIG = {
       "Analyze the codebase to find the data entities (models) that should be ingested into Algolia.",
       "For each entity, return its name, the file path(s) where it is defined, and its indexable attribute keys (the fields a user would search or filter on).",
       "Inspect the source of each entity to extract real field names for attributes \u2014 do not guess or leave attributes empty.",
-      "Entities live wherever the stack keeps them: TypeScript interfaces or a Prisma schema, Django models.py, Pydantic models.",
+      "Entities live wherever the stack keeps them: TypeScript interfaces or a Prisma schema, Django models.py, Rails app/models, Laravel Eloquent models, Go structs, Pydantic models.",
       "Prefer domain models (e.g. Document, Product, User) over framework or infrastructure types.",
       "Use as few tools as possible, but do not guess. If you cannot find any entities, return an empty array.",
       "Ignore directories that may be related to testing, like `/fixtures`, `/tests`, etc",
@@ -3087,7 +3187,7 @@ var MODE_CONFIG = {
   verification: {
     instructions: [
       "Analyze the codebase to determine which code-quality tools are available to validate changes.",
-      "Look at the dependency manifest and config files for the project's languages: package.json scripts with tsconfig/eslint/prettier, pyproject.toml or setup.cfg (ruff, mypy, black).",
+      "Look at the dependency manifest and config files for the project's languages: package.json scripts with tsconfig/eslint/prettier, pyproject.toml or setup.cfg (ruff, mypy, black), Gemfile with .rubocop.yml, composer.json scripts (phpstan, pint), go.mod with a golangci-lint config.",
       'Return the tool names as an array, e.g. ["eslint", "prettier", "tsc"] or ["ruff", "mypy"].',
       "Use as few tools as possible, but do not guess. If you cannot find any, return an empty array.",
       "Ignore directories that may be related to testing, like `/fixtures`, `/tests`, etc",
@@ -3115,7 +3215,7 @@ async function runAnalysis(mode, extraInstructions = []) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.8.0-rc.60.48",
+  version: "0.8.0-rc.63.52",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {

package/docs/algolia-sdk/README.md

@@ -17,6 +17,9 @@ Install the latest stable within the major; never pin an exact patch.
 | --- | --- | --- |
 | JavaScript/TypeScript | `algoliasearch` | `^5` |
 | Python | `algoliasearch` | `>=4,<5` |
+| Ruby | `algolia` | `~> 3.0` |
+| PHP | `algolia/algoliasearch-client-php` | `^4` |
+| Go | `github.com/algolia/algoliasearch-client-go/v4` | `v4` |
 
 ## Search UI
 

package/docs/algolia-sdk/save-records-go.md

@@ -0,0 +1,62 @@
+# Save records (algoliasearch-client-go v4)
+
+Adds records to an index. Write op — use a **write key**, server-side only.
+
+Imports are the dependency declaration; `go mod tidy` resolves
+`github.com/algolia/algoliasearch-client-go/v4`. Standalone `package main` file,
+run with `go run`. Nothing panics on its own — every call returns `(value, error)`.
+
+```go
+package main
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/algolia/algoliasearch-client-go/v4/algolia/search"
+)
+
+func main() {
+	client, err := search.NewClient(os.Getenv("ALGOLIA_APPLICATION_ID"), os.Getenv("ALGOLIA_WRITE_API_KEY"))
+	if err != nil {
+		panic(err) // NewClient fails on an empty/invalid app ID or key
+	}
+
+	indexName := "products"
+	records := []map[string]any{{"objectID": "1", "name": "Hot 100"}}
+
+	if _, err := client.SaveObjects(indexName, records, search.WithWaitForTasks(true)); err != nil {
+		panic(err)
+	}
+
+	fmt.Printf("ALGOLIA_WIZARD_RECORD_COUNT=%d\n", len(records))
+}
+```
+
+```go
+func (c *APIClient) SaveObjects(
+	indexName string,
+	objects []map[string]any,   // maps only, each with an "objectID"
+	opts ...ChunkedBatchOption, // search.WithWaitForTasks(bool), search.WithBatchSize(int) (default 1000)
+) ([]BatchResponse, error)     // BatchResponse{ TaskID int64; ObjectIDs []string }
+```
+
+One `BatchResponse` per batch of 1,000, not per record — `len(res)` is the batch count.
+
+Read records from a JSON file:
+
+```go
+import "encoding/json"
+
+content, err := os.ReadFile("records.json")
+if err != nil {
+	panic(err)
+}
+var records []map[string]any
+if err := json.Unmarshal(content, &records); err != nil {
+	panic(err)
+}
+```
+
+After a successful ingest print `ALGOLIA_WIZARD_RECORD_COUNT=<n>` (n = records
+read, not `len(res)`) as the last stdout line, trailing newline included.

package/docs/algolia-sdk/save-records-php.md

@@ -0,0 +1,50 @@
+# Save records (algoliasearch-client-php v4)
+
+Adds records to an index. Write op — use a **write key**, server-side only.
+
+Dependency: `algolia/algoliasearch-client-php` `^4` — the wizard runs
+`composer require` for you; do not hand-edit `composer.json`.
+
+`require 'vendor/autoload.php'` before anything else, or the class won't resolve
+(from `.algolia-wizard/` the path is `__DIR__.'/../vendor/autoload.php'`).
+
+```php
+<?php
+
+require __DIR__.'/../vendor/autoload.php';
+
+use Algolia\AlgoliaSearch\Api\SearchClient;
+
+$appId = getenv('ALGOLIA_APPLICATION_ID');
+$apiKey = getenv('ALGOLIA_WRITE_API_KEY');
+$indexName = 'playlists';
+
+$client = SearchClient::create($appId, $apiKey);
+$records = [['objectID' => '1', 'name' => 'Hot 100', 'visibility' => 'public']];
+
+$responses = $client->saveObjects($indexName, $records, true);
+```
+
+```php
+saveObjects(
+    string $indexName,        // required
+    array $objects,           // required
+    bool $waitForTasks = false,
+    int $batchSize = 1000,
+    array $requestOptions = []
+) // => array of batch responses, one per 1,000-record batch
+```
+
+Unlike the typed clients, PHP returns **plain associative arrays**, not objects:
+`$responses[0]['taskID']`, `$responses[0]['objectIDs']`. Always an array of them —
+never treat it as one response.
+
+Read records from a JSON file:
+
+```php
+$records = json_decode(file_get_contents($recordsPath), true);
+```
+
+After a successful ingest, print `ALGOLIA_WIZARD_RECORD_COUNT=<n>` as the last
+stdout line (`echo 'ALGOLIA_WIZARD_RECORD_COUNT='.count($records)."\n";`), with no
+other output after it.

package/docs/algolia-sdk/save-records-ruby.md

@@ -0,0 +1,48 @@
+# Save records (algolia v3)
+
+Adds records to an index. Write op — use a **write key**, server-side only.
+
+Dependency: gem `algolia`, `~> 3.0` (`gem 'algolia', '~> 3.0'`).
+
+`require "algolia"` (gem name is `algolia`, not `algoliasearch`). Build the client
+with `Algolia::SearchClient.create`.
+
+```ruby
+require "algolia"
+
+app_id = ENV.fetch("ALGOLIA_APPLICATION_ID")
+api_key = ENV.fetch("ALGOLIA_WRITE_API_KEY")
+index_name = "playlists"
+
+client = Algolia::SearchClient.create(app_id, api_key)
+
+records = [{ "objectID" => "1", "name" => "Hot 100", "visibility" => "public" }]
+
+responses = client.save_objects(index_name, records, true)
+```
+
+```ruby
+save_objects(
+  index_name,             # String, required
+  objects,                # Array<Hash>, required
+  wait_for_tasks = false,
+  batch_size = 1000,
+  request_options = {}
+) # => Array<Algolia::Search::BatchResponse>, one entry per 1,000-record batch
+```
+
+Args are **positional**, and every method/field is **snake_case**: read
+`r.task_id` and `r.object_ids`, not `taskID`/`objectIDs`. The return value is an
+array — never treat it as one object.
+
+Read records from a JSON file:
+
+```ruby
+require "json"
+
+records = JSON.parse(File.read(records_path))
+```
+
+After a successful ingest, print `ALGOLIA_WIZARD_RECORD_COUNT=<n>` as the last
+stdout line (`puts "ALGOLIA_WIZARD_RECORD_COUNT=#{records.length}"`), with no
+other output after it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algolia/wizard",
-  "version": "0.8.0-rc.60.48",
+  "version": "0.8.0-rc.63.52",
   "description": "Magically implement Algolia functionality in your codebase",
   "type": "module",
   "engines": {