Spectacles

Fixed

• Every vision and embedding request failed with Class "yii\httpclient\Client" not found. The shared HTTP helper all eight providers call through depends on yiisoft/yii2-httpclient, which was never declared as a requirement and is not pulled in by craftcms/cms — so no provider could reach its API. It is now an explicit dependency.
• composer install could not resolve the dependency tree: craftcms/phpstan (which publishes only dev-main) requires PHPStan 1.x, while the root package asked for ^2.0. PHPStan is now pinned to ^1.12.

Added

• Test suites. PHPUnit covers provider-agnostic logic (cosine similarity, response normalization, JSON extraction, pgvector literal formatting); Codeception with Craft's test framework covers everything needing a booted Craft — settings validation, the metadata record and its JSON columns, the similarity/metadata/vision services, the Twig variable, event wiring, and the public endpoints' rate limiting.
• A DDEV config so the toolchain runs without a local PHP install, plus a ddev test command for the suites and static analysis.

First public release. The version is aligned with the Craft 5 major version the plugin targets, superseding the internal 1.x line.

Added

• Per-IP rate limiting on the public search endpoints, configurable via the new publicSearchRateLimit and publicSearchRateWindow settings (each request can trigger a paid vision/embedding call). Set the limit to 0 to disable.

Changed

• Auto-analyze now runs only on a brand-new upload or a file replacement. It no longer re-runs on unrelated edits (title, focal point, moves), drafts, revisions, or the duplicate saves that multi-site propagation fires — eliminating redundant paid API calls.
• GET /spectacles/similar/<assetId> now respects the "Allow public visitor uploads" setting, and a visitor-supplied limit is clamped to 100.

Fixed

• The plugin settings page is now reachable. A getSettingsResponse() override redirected the settings URL to itself, causing an infinite redirect loop (ERR_TOO_MANY_REDIRECTS); the default Craft behavior renders the settings template directly.
• pgvector search no longer errors when the vector table contains mixed embedding dimensions (e.g. mid-provider-switch); mismatched-dimension rows are skipped, matching the scan backend.

Removed

• Dead Metadata::deleteForAsset(). Asset deletions are handled by the database's ON DELETE CASCADE, which correctly preserves metadata across soft-delete/restore.

Added

• Pluggable similarity backends (SimilarityBackend interface).
• PgvectorBackend — Postgres vector column + cosine distance, auto-detected when the extension is installed. Migration creates spectacles_imagevectors on Postgres + pgvector and is a no-op everywhere else.
• Settings: vectorIndex (auto / scan / pgvector).
• Quick-preset buttons on the settings screen: Best quality (Claude + Voyage), Balanced (OpenAI), Cheapest (Gemini), Self-hosted (Ollama).
• CP asset edit sidebar panel showing description, tags, similar-image thumbnails, and an "Analyze now" action for un-analyzed images.
• POST /spectacles/analyze-asset (CP) for single-asset analysis.

Changed

• Similarity::similarToVector now delegates to the active backend.
• Metadata::store keeps the JSON embedding for portability and also writes to the active backend's index, so switching backends is reversible without re-calling the vision API.

Added

• Initial release.
• Vision providers: OpenAI, Anthropic, Google Gemini, Ollama (self-hosted).
• Embedding providers: OpenAI, Google Gemini, Voyage AI (multimodal), Ollama.
• Multimodal-aware embedding pipeline — embeds image bytes directly when the provider supports it (Voyage), falls back to text otherwise.
• Independent vision + embedding configuration.
• Auto-analyze queue job on asset save.
• spectacles_imagemetadata table with description, tags, objects, colors, and embedding.
• Public POST /spectacles/search endpoint for visitor uploads.
• GET /spectacles/similar/<assetId> JSON endpoint.
• craft.spectacles.similar(asset), searchText(query), metadataFor(asset) Twig helpers.
• CP settings screen + bulk re-index button.
• Cosine similarity gracefully skips records whose vector dimension does not match the query (so switching providers degrades to "needs re-index" rather than crashing).