maglev-rb 0.1.1 → 0.2.1

data/lib/tasks/maglev.rake

@@ -1,6 +1,37 @@
 # frozen_string_literal: true
 
 namespace :maglev do
+  desc "Inspect a built gem before release: rake maglev:release_audit[path]"
+  task :release_audit, [:path] do |_task, args|
+    require "rubygems/package"
+    require "stringio"
+    require "zlib"
+
+    path = args[:path] || Dir[File.expand_path("../../pkg/maglev-rb-*.gem", __dir__)].max
+    raise "built gem not found" unless path && File.file?(path)
+
+    package = Gem::Package.new(path)
+    specification = package.spec
+    raise "gem version mismatch" unless specification.version.to_s == Maglev::VERSION
+
+    files = []
+    File.open(path, "rb") do |io|
+      Gem::Package::TarReader.new(io) do |outer|
+        outer.each do |entry|
+          next unless entry.full_name == "data.tar.gz"
+
+          Zlib::GzipReader.wrap(StringIO.new(entry.read)) do |gzip|
+            Gem::Package::TarReader.new(gzip) { |inner| inner.each { |item| files << item.full_name } }
+          end
+        end
+      end
+    end
+    forbidden = files.grep(%r{(?:^|/)(?:tmp|log|spec)/|AGENTS|IMPLEMENTATION_PLAN|TODO|local_secret})
+    raise "forbidden packaged files: #{forbidden.join(", ")}" if forbidden.any?
+
+    puts "Release audit passed: #{specification.name} #{specification.version} (#{files.size} files)"
+  end
+
   desc "Reindex one Maglev model: rails maglev:reindex[ModelName]"
   task :reindex, [:model_name] => :environment do |_task, args|
     model_name = args[:model_name]
@@ -28,4 +59,16 @@ namespace :maglev do
       puts "- #{schema.fetch(:model)} fields=#{schema.fetch(:exposed_attributes).join(",")}"
     end
   end
+
+  desc "Score a provider-free Maglev planner evaluation corpus"
+  task :evaluate_planner, [:path] do |_task, args|
+    path = args[:path] || File.expand_path("../../spec/dummy/evaluations/planner_v1.json", __dir__)
+    corpus = Maglev::PlannerEvaluation.load(path)
+    report = Maglev::PlannerEvaluation.score(corpus.fetch("cases"))
+    percentage = (report.fetch(:score) * 100).round(1)
+    puts "Planner evaluation v#{corpus.fetch("version")}: #{report.fetch(:passed)}/#{report.fetch(:total)} passed (#{percentage}%)"
+    report.fetch(:cases).reject { |item| item.fetch(:passed) }.each do |item|
+      puts "- #{item.fetch(:id)}: #{item.fetch(:failure_class)}"
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: maglev-rb
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
 platform: ruby
 authors:
 - Maglev contributors
@@ -44,19 +44,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '9.0'
 - !ruby/object:Gem::Dependency
-  name: ruby_llm
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -71,6 +71,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: parallel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.10'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.10'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -127,21 +147,27 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.44'
-description: Maglev adds semantic search and grounded RAG to ActiveRecord object graphs.
+description: Maglev provides safe structured queries, semantic retrieval, and bounded
+  hybrid workflows over registered ActiveRecord resources.
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE.txt
+- README.ja.md
 - README.md
 - README.zh-CN.md
 - lib/generators/maglev/install/install_generator.rb
+- lib/generators/maglev/upgrade_index_version/upgrade_index_version_generator.rb
+- lib/generators/maglev/upgrade_source_identity/upgrade_source_identity_generator.rb
+- lib/maglev-rb.rb
 - lib/maglev.rb
 - lib/maglev/active_record_extension.rb
-- lib/maglev/adapters/ruby_llm_attachment_extractor.rb
-- lib/maglev/adapters/ruby_llm_embedding.rb
-- lib/maglev/adapters/ruby_llm_generation.rb
-- lib/maglev/adapters/ruby_llm_provider.rb
+- lib/maglev/adapters/faraday_client.rb
+- lib/maglev/adapters/faraday_embedding.rb
+- lib/maglev/adapters/faraday_generation.rb
+- lib/maglev/adapters/faraday_planner.rb
 - lib/maglev/answerer.rb
 - lib/maglev/attachment_extractor.rb
 - lib/maglev/authorization.rb
@@ -156,22 +182,56 @@ files:
 - lib/maglev/errors.rb
 - lib/maglev/extracted_document.rb
 - lib/maglev/generation_adapter.rb
+- lib/maglev/hybrid_candidate_set.rb
+- lib/maglev/hybrid_coordinator.rb
+- lib/maglev/hybrid_result.rb
+- lib/maglev/index_diagnostics.rb
+- lib/maglev/index_identity.rb
+- lib/maglev/index_state.rb
 - lib/maglev/indexer.rb
 - lib/maglev/knowledge_config.rb
+- lib/maglev/knowledge_registry.rb
+- lib/maglev/planner.rb
+- lib/maglev/planner_adapter.rb
+- lib/maglev/planner_evaluation.rb
 - lib/maglev/prompt_builder.rb
 - lib/maglev/provider_call.rb
 - lib/maglev/provider_configuration.rb
+- lib/maglev/query_compiler.rb
+- lib/maglev/query_ir.rb
+- lib/maglev/query_validator.rb
 - lib/maglev/railtie.rb
+- lib/maglev/registry.rb
 - lib/maglev/reindex_job.rb
+- lib/maglev/relation_order.rb
+- lib/maglev/request.rb
+- lib/maglev/request_executor.rb
+- lib/maglev/resource_config.rb
 - lib/maglev/response.rb
+- lib/maglev/result.rb
+- lib/maglev/retrieval_outcome.rb
+- lib/maglev/retrieval_result.rb
 - lib/maglev/retriever.rb
+- lib/maglev/router.rb
+- lib/maglev/routing_adapter.rb
 - lib/maglev/schema_compiler.rb
+- lib/maglev/schema_snapshot.rb
 - lib/maglev/search_result.rb
 - lib/maglev/snapshot.rb
+- lib/maglev/snapshot_budget.rb
 - lib/maglev/snapshot_builder.rb
+- lib/maglev/source_extractor.rb
+- lib/maglev/source_fragment.rb
+- lib/maglev/structured_answer_composer.rb
+- lib/maglev/structured_evidence_builder.rb
+- lib/maglev/structured_executor.rb
+- lib/maglev/structured_result.rb
+- lib/maglev/trace.rb
 - lib/maglev/vector_stores/base.rb
 - lib/maglev/vector_stores/document.rb
+- lib/maglev/vector_stores/document_id.rb
 - lib/maglev/vector_stores/memory.rb
+- lib/maglev/vector_stores/metadata_filter.rb
 - lib/maglev/vector_stores/pgvector.rb
 - lib/maglev/version.rb
 - lib/tasks/maglev.rake
@@ -189,7 +249,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -198,5 +258,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.10
 specification_version: 4
-summary: Rails-native semantic knowledge layer for ActiveRecord object graphs.
+summary: Rails-native knowledge and query layer for ActiveRecord applications.
 test_files: []

data/lib/maglev/adapters/ruby_llm_attachment_extractor.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../attachment_extractor"
-
-module Maglev
-  module Adapters
-    class RubyLLMAttachmentExtractor < AttachmentExtractor
-      def extract(blob, source_name:)
-        require "ruby_llm"
-
-        super
-      end
-    end
-  end
-end

data/lib/maglev/adapters/ruby_llm_embedding.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../embedding_adapter"
-require_relative "../provider_configuration"
-require_relative "ruby_llm_provider"
-
-module Maglev
-  module Adapters
-    class RubyLLMEmbedding < EmbeddingAdapter
-      def initialize(provider: Maglev.configuration.embedding_provider, model: nil, dimensions: nil)
-        configuration = provider.to_h
-        configuration[:model] = model if model
-        configuration[:dimensions] = dimensions if dimensions
-        @client = RubyLLMProvider.new(ProviderConfiguration.new(**configuration))
-      end
-
-      def embed(text)
-        @client.embed(text)
-      end
-    end
-  end
-end

data/lib/maglev/adapters/ruby_llm_generation.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../configuration"
-require_relative "../generation_adapter"
-require_relative "../provider_configuration"
-require_relative "ruby_llm_provider"
-
-module Maglev
-  module Adapters
-    class RubyLLMGeneration < GenerationAdapter
-      def initialize(provider: Maglev.configuration.generation_provider, model: nil)
-        configuration = provider.to_h
-        configuration[:model] = model if model
-        @client = RubyLLMProvider.new(ProviderConfiguration.new(**configuration))
-      end
-
-      def generate(prompt)
-        @client.generate(prompt)
-      end
-    end
-  end
-end

data/lib/maglev/adapters/ruby_llm_provider.rb

@@ -1,64 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../errors"
-
-module Maglev
-  module Adapters
-    class RubyLLMProvider
-      def initialize(provider)
-        @provider = provider
-      end
-
-      def embed(text)
-        result = translate_errors do
-          context.embed(
-            text,
-            model: @provider.model,
-            provider: :openai,
-            assume_model_exists: true,
-            dimensions: @provider.dimensions
-          )
-        end
-        result.vectors.first.is_a?(Array) ? result.vectors.first : result.vectors
-      end
-
-      def generate(prompt)
-        response = translate_errors do
-          context.chat(
-            model: @provider.model,
-            provider: :openai,
-            assume_model_exists: true
-          ).ask(prompt)
-        end
-        response.respond_to?(:content) ? response.content : response.to_s
-      end
-
-      private
-
-      def context
-        @context ||= begin
-          require "ruby_llm"
-
-          RubyLLM.context do |configuration|
-            configuration.openai_api_base = @provider.url
-            configuration.openai_api_key = @provider.api_key
-            configuration.request_timeout = Maglev.configuration.provider_timeout
-            configuration.max_retries = 0
-            configuration.logger = Maglev.configuration.logger
-          end
-        end
-      end
-
-      def translate_errors
-        yield
-      rescue RubyLLM::RateLimitError, RubyLLM::OverloadedError,
-        RubyLLM::ServerError, RubyLLM::ServiceUnavailableError,
-        Faraday::TimeoutError, Faraday::ConnectionFailed => error
-        raise RetryableProviderError, error.message
-      rescue RubyLLM::Error, RubyLLM::ConfigurationError,
-        RubyLLM::ModelNotFoundError => error
-        raise PermanentProviderError, error.message
-      end
-    end
-  end
-end