vectra-client 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c00aee137978894b5722853a5aa6419c76a4613fd07e7b772df83c0ffddcebd
-  data.tar.gz: 92f2e588d62520f695d59feaf74d6e1787efc8c1044cf92a8cf94251dcd9ce3a
+  metadata.gz: 15a003ec47ff2de6ec1977426169ffe1739f5fc9ba07cfcd717ca9cb88fd398f
+  data.tar.gz: ed77f5c22fd580990ee4beaa1840175329c3feda9dd9b6087ad6ff93fec9743a
 SHA512:
-  metadata.gz: df1fa8e851978d7167e55d1df5d8718a01923b533ea10d314c24a570f84c1440dcb41bcad20ab9226206d742f03b8f3deb8aaf34d327f63fe5744345a9827127
-  data.tar.gz: 0f10f1ffa2f782f018d94d9c24a2311662ee4256f7c68495d233eb018220a023df5732e2fb541d302624ac543928d957f6ed6adb6bf34efe50e31a1f231c7d54
+  metadata.gz: aa3f0556520ceb6677816ffa26ec4beac0fa85f660bdebf28578f47b834c43b87ab5208057ca81b96a9e52a9dd3e645e1c406ceab254a2ade5c716fdcb7a497d
+  data.tar.gz: 55c2e660ba45abc710cd6d9bc978df5d6c5f23e1e9c058359e719d4d2d43e523af30207fa2ad5b049eb87b698c52c5adf59fe37c4619224986a3c0295d8a408f

data/.rubocop.yml

@@ -14,9 +14,11 @@ AllCops:
 
 # Layout
 Layout/LineLength:
-  Max: 120
+  Max: 185
   AllowedPatterns:
     - '\A\s*#' # Allow long comment lines
+  Exclude:
+    - 'vectra.gemspec'
 
 Layout/MultilineMethodCallIndentation:
   EnforcedStyle: indented
@@ -28,7 +30,7 @@ Metrics/BlockLength:
     - 'vectra.gemspec'
     - 'Rakefile'
     - 'benchmarks/**/*'
-  ExcludedMethods:
+  AllowedMethods:
     - 'included'
     - 'class_methods'
 
@@ -82,10 +84,10 @@ Style/FrozenStringLiteralComment:
   EnforcedStyle: always
 
 Style/SymbolArray:
-  EnforcedStyle: brackets
+  Enabled: false
 
 Style/WordArray:
-  EnforcedStyle: brackets
+  Enabled: false
 
 Style/TrailingCommaInArrayLiteral:
   EnforcedStyleForMultiline: no_comma
@@ -96,6 +98,9 @@ Style/TrailingCommaInHashLiteral:
 Style/TrailingCommaInArguments:
   EnforcedStyleForMultiline: no_comma
 
+Style/MapIntoArray:
+  Enabled: false
+
 # Naming
 Naming/MethodParameterName:
   AllowedNames:
@@ -103,6 +108,13 @@ Naming/MethodParameterName:
     - to
     - db
     - io
+    - n
+
+Naming/PredicatePrefix:
+  Enabled: false # Allow has_vector DSL method
+
+Naming/MemoizedInstanceVariableName:
+  Enabled: false # Allow descriptive names
 
 # Lint
 Lint/MissingSuper:
@@ -111,12 +123,15 @@ Lint/MissingSuper:
 Lint/ScriptPermission:
   Enabled: false
 
+Lint/RedundantDirGlobSort:
+  Enabled: false
+
 # RSpec specific
 RSpec/ExampleLength:
-  Max: 15
+  Max: 25
 
 RSpec/MultipleExpectations:
-  Max: 5
+  Max: 10
 
 RSpec/MultipleMemoizedHelpers:
   Max: 10
@@ -125,9 +140,7 @@ RSpec/NestedGroups:
   Max: 5
 
 RSpec/DescribeClass:
-  Enabled: true
-  Exclude:
-    - 'spec/integration/**/*'
+  Enabled: false
 
 RSpec/ContextWording:
   Enabled: false
@@ -144,60 +157,87 @@ RSpec/VerifiedDoubles:
 RSpec/MultipleDescribes:
   Enabled: false
 
-RSpec/DescribeClass:
-  Enabled: false # Allow string descriptions
+RSpec/LeadingSubject:
+  Enabled: false
 
-# Disable problematic Capybara cop
-Capybara/RSpec/PredicateMatcher:
+RSpec/NamedSubject:
+  Enabled: false
+
+RSpec/SubjectStub:
+  Enabled: false
+
+RSpec/DescribedClass:
   Enabled: false
 
 # Gemspec
 Gemspec/DevelopmentDependencies:
   Enabled: false
 
-# Naming
-Naming/MemoizedInstanceVariableName:
-  Enabled: false # Allow descriptive names
+Gemspec/OrderedDependencies:
+  Enabled: false
 
-# Layout
-Layout/LineLength:
-  Max: 185
-  Exclude:
-    - 'vectra.gemspec'
+# Capybara - disable all (causes errors and not needed for this project)
+Capybara/RSpec/PredicateMatcher:
+  Enabled: false
 
-# Additional disables for auto-correctable minor issues
-Style/SymbolArray:
+Capybara/CurrentPathExpectation:
   Enabled: false
 
-Style/WordArray:
+Capybara/MatchStyle:
   Enabled: false
 
-Style/MapIntoArray:
+Capybara/NegationMatcher:
   Enabled: false
 
-Lint/RedundantDirGlobSort:
+Capybara/SpecificActions:
   Enabled: false
 
-RSpec/LeadingSubject:
+Capybara/SpecificFinders:
   Enabled: false
 
-RSpec/ExampleLength:
-  Max: 25
+Capybara/SpecificMatcher:
+  Enabled: false
 
-RSpec/MultipleExpectations:
-  Max: 10
+Capybara/VisibilityMatcher:
+  Enabled: false
 
-RSpec/NamedSubject:
+# FactoryBot - not used in this project
+FactoryBot/AttributeDefinedStatically:
   Enabled: false
 
-RSpec/SubjectStub:
+FactoryBot/ConsistentParenthesesStyle:
   Enabled: false
 
-RSpec/DescribedClass:
+FactoryBot/CreateList:
   Enabled: false
 
-Naming/PredicateName:
-  Enabled: false  # Allow has_vector DSL method
+FactoryBot/FactoryClassName:
+  Enabled: false
 
-Gemspec/OrderedDependencies:
+FactoryBot/FactoryNameStyle:
+  Enabled: false
+
+FactoryBot/SyntaxMethods:
+  Enabled: false
+
+# RSpecRails - not used in this project
+RSpecRails/AvoidSetupHook:
+  Enabled: false
+
+RSpecRails/HaveHttpStatus:
+  Enabled: false
+
+RSpecRails/HttpStatus:
+  Enabled: false
+
+RSpecRails/InferredSpecType:
+  Enabled: false
+
+RSpecRails/MinitestAssertions:
+  Enabled: false
+
+RSpecRails/NegationBeValid:
+  Enabled: false
+
+RSpecRails/TravelAround:
   Enabled: false

data/CHANGELOG.md

@@ -7,6 +7,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2025-01-08
+
+### Added
+
+- **Async Batch Operations** (`Vectra::Batch`)
+  - Concurrent batch upsert with configurable worker count
+  - Automatic chunking of large vector sets
+  - Async delete and fetch operations
+  - Error aggregation and partial success handling
+
+- **Streaming Results** (`Vectra::Streaming`)
+  - Lazy enumeration for large query result sets
+  - Memory-efficient processing with automatic pagination
+  - `query_each` and `query_stream` methods
+  - Duplicate detection across pages
+
+- **Caching Layer** (`Vectra::Cache` and `Vectra::CachedClient`)
+  - In-memory LRU cache with configurable TTL
+  - Transparent caching for query and fetch operations
+  - Index-level cache invalidation
+  - Thread-safe with mutex synchronization
+
+- **Connection Pool with Warmup** (`Vectra::Pool`)
+  - Configurable pool size and checkout timeout
+  - Connection warmup at startup
+  - Health checking and automatic reconnection
+  - Pool statistics and monitoring
+
+- **CI Benchmark Integration**
+  - Weekly scheduled benchmark runs
+  - PostgreSQL (pgvector) integration in CI
+  - Benchmark result artifact storage
+
+### Configuration
+
+New configuration options:
+- `cache_enabled` - Enable/disable caching (default: false)
+- `cache_ttl` - Cache time-to-live in seconds (default: 300)
+- `cache_max_size` - Maximum cache entries (default: 1000)
+- `async_concurrency` - Concurrent workers for batch ops (default: 4)
+
+### Dependencies
+
+- Added `concurrent-ruby ~> 1.2` for thread-safe operations
+
 ## [0.2.1] - 2025-01-08
 
 ### Added
@@ -109,16 +154,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Planned
 
-### [0.3.0]
+### [0.4.0]
 
 - Weaviate provider implementation
-- Batch operation improvements
-- Performance optimizations
-- Async operations support
+- Additional similarity metrics
+- Vector quantization support
 
 ### [1.0.0]
 
-- Rails integration
-- ActiveRecord-like DSL for vector models
 - Background job integration (Sidekiq, GoodJob)
 - Production-ready with full documentation
+- Performance monitoring dashboard