6.1.0

What's Changed

• Restore the NaturalLanguage-backed vectura-cli and TestExamples executable.
• Add CLI README coverage and Codemagic smoke validation.
• Add NLContextualEmbedder adapter coverage for vector queries.
• Count file-backed documents from disk so partially loaded caches do not report stale totals.

Full Changelog: 6.0.0...6.1.0

6.0.0

What's Changed

• [codex] Remove swift-embeddings backend from core by @rudrankriyam in #83

Full Changelog: 5.3.0...6.0.0

5.3.0

What's Changed

• Add VecturaOAIKit as a package target by @subsriram in #81

Full Changelog: 5.2.1...5.3.0

5.2.1

What's Changed

• [codex] Pin swift-embeddings to stable 0.0.26 by @rudrankriyam in #80

Full Changelog: 5.2.0...5.2.1

5.2.0

What's Changed

• Add getDocument, documentExists API and fix delete no-op bug by @thatswiftguy in #77

New Contributors

• @thatswiftguy made their first contribution in #77

Full Changelog: 5.1.0...5.2.0

5.1.0

What's Changed

• Improve storage and BM25 search performance by @rudrankriyam in #74
• Use bounded top-K selection to avoid full result sorting by @rudrankriyam in #75
• Add realistic workload benchmark profile and optional CI stage by @rudrankriyam in #76

Full Changelog: 5.0.0...5.1.0

5.0.0

Highlights

• Add core SwiftEmbedder model-family resolution refactor and static embedding dimension handling improvements.
• Add ModernBERT support in SwiftEmbedder.
• Add RoBERTa and XLM-RoBERTa support in SwiftEmbedder.
• Add embedder validation and BERT fallback robustness fixes.
• Align package platform minimums with runtime requirements and clean up redundant availability guardrails.

Included pull requests

• #69 Refactor SwiftEmbedder core model resolution
• #70 Add ModernBERT support to SwiftEmbedder
• #71 Add RoBERTa and XLM-RoBERTa support to SwiftEmbedder
• #72 Embedder validation and errors
• #73 Raise platform minimums and remove availability guards

4.0.0

Breaking Changes

• VecturaMLXKit extracted to separate repository: VecturaMLXKit, VecturaMLXCLI, and MLX-related tests have been moved to rryam/VecturaMLXKit. This removes the need for Package Traits (SE-0450).
• Package Traits removed: The MLX trait no longer exists. MLX users should add VecturaMLXKit as a separate dependency.
• swift-tools-version reverted to 6.0: Swift 6.1 is no longer required for this package.
• mlx-swift-lm dependency removed: This package no longer pulls in any MLX-related dependencies.

Migration

Before (3.0.0 with traits):

.package(url: "https://github.com/rryam/VecturaKit.git", from: "3.0.0", traits: ["MLX"])

After (4.0.0):

.package(url: "https://github.com/rryam/VecturaKit.git", from: "4.0.0"),
.package(url: "https://github.com/rryam/VecturaMLXKit.git", from: "1.0.0"),

Both packages can be added directly via Xcode's "Add Package Dependencies" UI -- no workarounds needed.

Fixes #66

Full Changelog

3.0.0...4.0.0

3.0.0

Highlights

• Package Traits (SE-0450): MLX dependencies are now optional. Consumers using only VecturaKit or VecturaNLKit no longer download the heavy mlx-swift-lm package, significantly improving build times.
• Swift 6.1+ Required: Bumped swift-tools-version to 6.1 for Package Traits support.
• Smaller Default Model: Switched from potion-retrieval-32M to potion-base-4M for faster downloads and CI.

Breaking Changes

• Swift 6.1+ / Xcode 16.3+ required
• MLX users must enable the trait explicitly:

  .package(url: "https://github.com/rryam/VecturaKit.git", from: "3.0.0", traits: ["MLX"])

Usage

Without MLX (lightweight):

.package(url: "https://github.com/rryam/VecturaKit.git", from: "3.0.0")

With MLX:

.package(url: "https://github.com/rryam/VecturaKit.git", from: "3.0.0", traits: ["MLX"])

Changes

• Added #if canImport(MLXEmbedders) guards to all MLX-dependent source files
• Updated CI to run MLX tests separately with --traits MLX
• Default model changed to minishlab/potion-base-4M (users can still specify the 32M model explicitly)

Full Changelog

2.5.3...3.0.0

2.5.3

Highlights

• Hardened add/index rollback to restore overwritten documents and keep storage/search consistent.
• Stricter config/input validation (DB name, search options, embedder inputs); BM25 handles empty queries safely.
• Performance suites now default to a deterministic embedder for faster runs (opt-in real embeddings via VECTURA_PERF_USE_SWIFT_EMBEDDER=1).
• Updated MLX dependencies to latest mlx-swift-lm (2.30.3 / mlx-swift 0.30.3).
• CLI vector dimension is auto-detected by default; indexed storage guide defaults aligned.

Changes

• Storage I/O and candidate loading now fail fast on partial batch failures.
• Added tests for BM25 index and config validation; stabilized perf/memory expectations.

Tests

• swift test -c release --filter PerformanceTests
• swift test