bitfab 0.74.3 → 0.75.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e04db08d34f7d195036216aa6f41ee940f81af773924508c2a12da97fbbd1e4a
-  data.tar.gz: 8fd59297c7eeb7e2d053ca2e4722d5b6aea43ae5c96f691a2addf81f0f9452ea
+  metadata.gz: 6976d07abea8e8c456185b0f5a76bbe861148e2a10baa1c3a65ac1a694b6993d
+  data.tar.gz: 072af5081f4c15e748478dbd058a8cc4c249804b345dcc70ed47b3e47f3c5830
 SHA512:
-  metadata.gz: aa1099e23b6af4619238c7b6b94f13e9ad15ead7aa6dcaa7fb5a993b634dd00ab6468c5924bcc717da520fa9f0e96d3d5e82a7ab32656e96885626b07e38c3e2
-  data.tar.gz: a99c779521142a681697cdadd6b031b1f2f181e851c919ec2f8e571dd3eb447eeccb6063380c5ee8ccfc706e420ef1e2fe23bc0fdd2eb5802e5930838372a075
+  metadata.gz: 5189232282c64908bada35335eac364e16bb6fcadfe9b677cdc5b3330735f59dbdebc6ff71fe4a2984ad1a5c8386b45ade841710c0b2ec1ac0d26c0d07c7d44f
+  data.tar.gz: 90b5fd0acb0d266e6f2e7d2b6d04dc4a08c66d3e1b25ce46f51425e5020cf372167c40ba141cf05c9f7e4f2348cc9a106f1888e9a5b792bbbe9a4f08d2bb0b80

data/lib/bitfab/verdicts.rb

@@ -194,12 +194,27 @@ module Bitfab
       end
     end
 
-    # Reads one trace's verdicts, or nil when the trace has none.
+    # Reads one trace's verdicts, or nil when the trace has none. See {#get_all} for the shape of each
+    # "evidence" item.
     def get(trace_id)
       get_all([trace_id]).first
     end
 
-    # Reads the verdicts of several traces.
+    # Reads the verdicts of several traces. Each trace and each entry of its "assertions" carries
+    # "evidence": nil, or an array of hashes, one per span cited, each with "spanId" and "text".
+    #
+    # Evidence written by Bitfab's assertion judge also carries "field", "ranges", and "spanChanged",
+    # which point at the exact passages the judge read. "field" is the span field the judge read
+    # ("summary", "input", "output", "reasoning", "content", "metadata", "errors", "contexts", or
+    # "llm_usage"). "ranges" are [start, end) character ranges into that field's text as the judge saw
+    # it: a string field as is, any other value as JSON indented by two spaces. Indexes are JavaScript
+    # string indexes (UTF-16 code units), not Ruby character indexes, so text outside the Basic
+    # Multilingual Plane counts two per character. Use them to highlight only when "spanChanged" is false.
+    #
+    # "spanChanged" is true when the span no longer matches what was judged: "text" is then only a short
+    # preview saved with the verdict, and "ranges" must not be used to highlight anything. When it is
+    # false, "text" is the full text of "ranges" read from the span, joined by a newline, an ellipsis,
+    # and a newline. Unknown keys are passed through as the server sent them.
     def get_all(trace_ids)
       return [] if trace_ids.empty?
 

data/lib/bitfab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bitfab
-  VERSION = "0.74.3"
+  VERSION = "0.75.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bitfab
 version: !ruby/object:Gem::Version
-  version: 0.74.3
+  version: 0.75.0
 platform: ruby
 authors:
 - Harvest Team