chore: Manual review end to end (#4)

Author: ankitml

examples/autocomplete/autocomplete.rb

@@ -27,11 +27,7 @@ def demo_autocomplete
                               .with_score
                               .order(search_score: :desc)
                               .limit(5)
-
-    results.each do |item|
-      puts format("  - %-50s (score: %.2f)", item.description.truncate(50), item.search_score)
-    end
-    puts "  (no results)" if results.empty?
+    puts results.map { |item| "  - #{item.description.truncate(50)} (score: #{item.search_score.round(2)})" }
   end
 end
 

examples/faceted_search/faceted_search.rb

@@ -25,22 +25,18 @@
   facets = relation.facets
 
   puts "Top results:"
-  rows.each do |item|
+  puts rows.map { |item|
     color = item.metadata&.fetch("color", nil) || "N/A"
-    stock = item.in_stock ? "In Stock" : "Out of Stock"
-    puts "  - #{item.description[0, 50]}... [#{item.category}] " \
-         "(rating: #{item.rating}, #{stock}, color: #{color})"
-  end
+    "  - #{item.description.truncate(50)} [#{item.category}] (rating: #{item.rating}, color: #{color})"
+  }
 
   puts "\nFacet buckets:"
   facets.each do |key, data|
     buckets = data.is_a?(Hash) ? Array(data["buckets"]) : []
     puts "#{key} (#{buckets.length} buckets)"
-    buckets.each do |bucket|
-      puts "  - #{bucket["key"]}: #{bucket["doc_count"]}"
-    end
+    puts buckets.map { |bucket| "  - #{bucket["key"]}: #{bucket["doc_count"]}" }
   end
 
-  puts "\n" + "=" * 60
+  puts "\n#{"=" * 60}"
   puts "Done!"
 end

examples/more_like_this/more_like_this.rb

@@ -4,7 +4,7 @@
 require_relative "../common"
 
 def demo_similar_to_single_product
-  puts "\n" + "=" * 60
+  puts "\n#{"=" * 60}"
   puts "Demo 1: Similar to a single product"
   puts "=" * 60
 
@@ -19,69 +19,55 @@ def demo_similar_to_single_product
                     .order(search_score: :desc)
                     .limit(5)
 
-  similar.each do |item|
+  puts similar.map { |item|
     marker = item.id == source_id ? " (source)" : ""
-    puts format("  %<id>d: %<desc>s... [%<category>s]%<marker>s",
-                id: item.id,
-                desc: item.description[0, 50],
-                category: item.category,
-                marker: marker)
-  end
+    "  #{item.id}: #{item.description.truncate(50)} [#{item.category}]#{marker}"
+  }
 end
 
 def demo_similar_to_multiple_products
-  puts "\n" + "=" * 60
+  puts "\n#{"=" * 60}"
   puts "Demo 2: Similar to multiple products (browsing history)"
   puts "=" * 60
 
   browsed_ids = [3, 12, 29]
   browsed = MockItem.where(id: browsed_ids)
 
   puts "\nUser's browsing history:"
-  browsed.each do |item|
-    puts "  #{item.id}: #{item.description[0, 50]}... [#{item.category}]"
-  end
+  puts browsed.map { |item| "  #{item.id}: #{item.description.truncate(50)} [#{item.category}]" }
 
-  relations = browsed_ids.map { |id| MockItem.more_like_this(id, fields: [:description]) }
-  combined = relations.reduce { |memo, relation| memo.or(relation) }
+  combined_description = browsed.pluck(:description).join(" ")
+  json_doc = { description: combined_description }.to_json
 
-  puts "\nRecommended products (similar to any browsed item):"
-  similar = combined.where.not(id: browsed_ids)
-                    .extending(ParadeDB::SearchMethods)
+  puts "\nRecommended products (similar to browsing history):"
+  similar = MockItem.more_like_this(json_doc)
+                    .where.not(id: browsed_ids)
                     .with_score
                     .order(search_score: :desc)
                     .limit(5)
 
-  similar.each do |item|
-    puts "  #{item.id}: #{item.description[0, 50]}... [#{item.category}]"
-  end
+  puts similar.map { |item| "  #{item.id}: #{item.description.truncate(50)} [#{item.category}]" }
 end
 
 def demo_combined_with_filters
-  puts "\n" + "=" * 60
-  puts "Demo 3: MoreLikeThis + ActiveRecord filters"
+  puts "\n#{"=" * 60}"
+  puts "Demo 3: MoreLikeThis + Filters (in_stock=true, rating >= 4)"
   puts "=" * 60
 
   source_id = 15
-  source = MockItem.find(source_id)
-  puts "\nSource: '#{source.description}' (rating: #{source.rating})"
 
-  puts "\nSimilar products (in_stock=true, rating >= 4):"
   results = MockItem.more_like_this(source_id, fields: [:description])
                     .where(in_stock: true)
                     .where("rating >= ?", 4)
                     .with_score
                     .order(search_score: :desc)
                     .limit(5)
 
-  results.each do |item|
-    stock = item.in_stock ? "In Stock" : "Out of Stock"
-    puts "  #{item.id}: #{item.description[0, 40]}... (rating: #{item.rating}, #{stock})"
-  end
+  puts results.map { |item| "  #{item.id}: #{item.description.truncate(40)} (rating: #{item.rating})" }
 end
 
 def demo_multifield_similarity
-  puts "\n" + "=" * 60
+  puts "\n#{"=" * 60}"
   puts "Demo 4: Multi-field similarity"
   puts "=" * 60
 
@@ -91,17 +77,11 @@ def demo_multifield_similarity
 
   puts "\nSimilar by DESCRIPTION only:"
   by_description = MockItem.more_like_this(source_id, fields: [:description]).where.not(id: source_id).limit(3)
-  by_description.each do |item|
-    puts "  #{item.id}: #{item.description[0, 40]}... [#{item.category}]"
-  end
+  puts by_description.map { |item| "  #{item.id}: #{item.description.truncate(40)} [#{item.category}]" }
 
   puts "\nSimilar by DESCRIPTION + CATEGORY:"
   by_both = MockItem.more_like_this(source_id, fields: [:description, :category]).where.not(id: source_id).limit(3)
-  by_both.each do |item|
-    puts "  #{item.id}: #{item.description[0, 40]}... [#{item.category}]"
-  end
-rescue ActiveRecord::StatementInvalid => error
-  puts "  (Skipped: #{error.message})"
+  puts by_both.map { |item| "  #{item.id}: #{item.description.truncate(40)} [#{item.category}]" }
 end
 
 if $PROGRAM_NAME == __FILE__
@@ -118,6 +98,6 @@ def demo_multifield_similarity
   demo_combined_with_filters
   demo_multifield_similarity
 
-  puts "\n" + "=" * 60
+  puts "\n#{"=" * 60}"
   puts "Done!"
 end

examples/quickstart/quickstart.rb

@@ -5,9 +5,8 @@
 
 def demo_basic_search
   puts "\n--- Basic Search: 'shoes' ---"
-  MockItem.search(:description).matching_all("shoes").limit(5).each do |item|
-    puts "  - #{item.description[0, 60]}..."
-  end
+  results = MockItem.search(:description).matching_all("shoes").limit(5)
+  puts results.map { |item| "  - #{item.description.truncate(60)}" }
 end
 
 def demo_scored_search
@@ -18,9 +17,7 @@ def demo_scored_search
                     .order(search_score: :desc)
                     .limit(5)
 
-  results.each do |item|
-    puts format("  - %-50s (score: %.2f)", "#{item.description[0, 50]}...", item.search_score.to_f)
-  end
+  puts results.map { |item| "  - #{item.description.truncate(50)} (score: #{item.search_score.round(2)})" }
 end
 
 def demo_phrase_search
@@ -31,9 +28,7 @@ def demo_phrase_search
                     .order(search_score: :desc)
                     .limit(5)
 
-  results.each do |item|
-    puts format("  - %-50s (score: %.2f)", "#{item.description[0, 50]}...", item.search_score.to_f)
-  end
+  puts results.map { |item| "  - #{item.description.truncate(50)} (score: #{item.search_score.round(2)})" }
 end
 
 def demo_snippet_highlighting
@@ -45,9 +40,7 @@ def demo_snippet_highlighting
                     .order(search_score: :desc)
                     .limit(3)
 
-  results.each do |item|
-    puts "  - #{item.description_snippet}"
-  end
+  puts results.map { |item| "  - #{item.description_snippet}" }
 end
 
 def demo_filtered_search
@@ -60,9 +53,7 @@ def demo_filtered_search
                     .order(search_score: :desc)
                     .limit(5)
 
-  results.each do |item|
-    puts "  - #{item.description[0, 40]}... (rating: #{item.rating})"
-  end
+  puts results.map { |item| "  - #{item.description.truncate(40)} (rating: #{item.rating})" }
 end
 
 if $PROGRAM_NAME == __FILE__

examples/rag/rag.rb

@@ -95,16 +95,14 @@ def generate(query, context)
             end
 
     puts "\nRetrieved #{items.length} products:"
-    items.each do |item|
-      puts format("  - %-60s (score: %.2f)", item.description, item.search_score.to_f)
-    end
+    puts items.map { |item| "  - #{item.description} (score: #{item.search_score.round(2)})" }
 
     context = format_context(items)
     puts "\nAnswer:"
     puts "-" * 40
     puts generate(query, context)
   end
 
-  puts "\n" + "=" * 60
+  puts "\n#{"=" * 60}"
   puts "Done!"
 end

spec/user_api_behavior_integration_spec.rb

@@ -69,12 +69,48 @@ def test_term_regex_and_fuzzy_execute
     assert_equal [1, 2], fuzzy_ids
   end
 
-  def test_more_like_this_executes_and_returns_similar_rows
+  def test_more_like_this_with_id_executes_and_returns_similar_rows
     ids = BehaviorProduct.more_like_this(3, fields: [:description]).limit(5).pluck(:id)
 
     assert_includes ids, 4
   end
 
+  def test_more_like_this_with_json_single_field_executes
+    json_doc = { description: "running shoes" }.to_json
+    ids = BehaviorProduct.more_like_this(json_doc).order(:id).pluck(:id)
+
+    assert_includes ids, 1
+    assert_includes ids, 2
+  end
+
+  def test_more_like_this_with_json_multiple_fields_executes
+    json_doc = { description: "running shoes", category: "footwear" }.to_json
+    ids = BehaviorProduct.more_like_this(json_doc).order(:id).pluck(:id)
+
+    assert_includes ids, 1
+    assert_includes ids, 2
+  end
+
+  def test_more_like_this_with_json_category_only_executes
+    json_doc = { category: "audio" }.to_json
+    ids = BehaviorProduct.more_like_this(json_doc).order(:id).pluck(:id)
+
+    assert_includes ids, 3
+    assert_includes ids, 4
+  end
+
+  def test_more_like_this_with_json_combined_with_filters_executes
+    json_doc = { description: "running" }.to_json
+    ids = BehaviorProduct.more_like_this(json_doc)
+                          .where(in_stock: true)
+                          .where("rating >= ?", 4)
+                          .order(:id)
+                          .pluck(:id)
+
+    assert_includes ids, 1
+    assert_includes ids, 2
+  end
+
   def test_with_score_and_with_snippet_materialize_columns
     rows = BehaviorProduct.search(:description)
                           .matching_all("running shoes")

spec/user_api_unit_spec.rb

@@ -80,11 +80,27 @@ def test_match_all_wrapper
     assert_sql_equal %(SELECT products.* FROM products WHERE ("products"."id" @@@ pdb.all())), sql
   end
 
-  def test_more_like_this
+  def test_more_like_this_with_id
     sql = UnitProduct.more_like_this(5, fields: [:description]).to_sql
     assert_sql_equal %(SELECT products.* FROM products WHERE ("products"."id" @@@ pdb.more_like_this(5, ARRAY['description']))), sql
   end
 
+  def test_more_like_this_with_json_string
+    sql = UnitProduct.more_like_this('{"description": "running shoes"}').to_sql
+    assert_sql_equal %(SELECT products.* FROM products WHERE ("products"."id" @@@ pdb.more_like_this('{"description": "running shoes"}'))), sql
+  end
+
+  def test_more_like_this_with_json_and_fields
+    sql = UnitProduct.more_like_this('{"description": "running shoes", "category": "footwear"}', fields: [:description, :category]).to_sql
+    assert_sql_equal %(SELECT products.* FROM products WHERE ("products"."id" @@@ pdb.more_like_this('{"description": "running shoes", "category": "footwear"}', ARRAY['description', 'category']))), sql
+  end
+
+  def test_more_like_this_with_json_hash
+    json_doc = { description: "running shoes", category: "footwear" }.to_json
+    sql = UnitProduct.more_like_this(json_doc).to_sql
+    assert_sql_equal %(SELECT products.* FROM products WHERE ("products"."id" @@@ pdb.more_like_this('{"description":"running shoes","category":"footwear"}'))), sql
+  end
+
   def test_excluding
     sql = UnitProduct.search(:description).matching_all("shoes").excluding("cheap").to_sql
     assert_sql_equal %(SELECT products.* FROM products WHERE ("products"."description" &&& 'shoes') AND (NOT ("products"."description" &&& 'cheap'))), sql