vicary 0.2.18 → 0.3.0

data/lib/vicary/candidates.rb

@@ -1993,6 +1993,30 @@ module Vicary
         out
       end
 
+      # A title abbreviation and the word it introduces, the title in any case.
+      # With a period every title in the set counts; without one only `mr` and
+      # `mrs`, because a bare `ms` or `dr` is as often "ms paint" or "dr" for drive.
+      TITLED_WORD_RE = /\b(?:(?:mrs|mr|ms|dr|prof)\.[ \t]+|(?:mrs|mr)[ \t]+)([A-Za-z][A-Za-z'’]*(?:-[A-Za-z][A-Za-z'’]*)*)/i
+
+      # A surname written in lowercase behind a title: "mr. kowalski". The
+      # lowercase route seeds on the given-name tier, so a surname alone never
+      # reaches it, and the capitalised route needs the capital the writer left
+      # off. A title is the one place the word after it is a name whatever its
+      # case, so the span is the title and that one word. A stop word or a single
+      # letter after the title is skipped.
+      def find_titled_lowercase_candidates(text, protected_span, settlement = nil)
+        out = []
+        each_match(text, TITLED_WORD_RE) do |m|
+          word = m[1]
+          start = m.begin(0)
+          stop = start + m[0].length
+          next if word.length < 2 || stop?(word.downcase) || protected_span.call(start, stop)
+
+          out << Candidate.new(m[0], start, stop, classify(words(m[0]), settlement))
+        end
+        out
+      end
+
       # Every name-shaped span, before any notability decision.
       #
       # High recall and deliberately poor precision — precision is what the
@@ -2166,6 +2190,12 @@ module Vicary
           ).each do |candidate|
             next if claimed.any? { |s, e| candidate.start < e && candidate.end > s }
 
+            out << candidate
+          end
+          claimed = out.map { |candidate| [candidate.start, candidate.end] }
+          find_titled_lowercase_candidates(text, is_protected, settlement).each do |candidate|
+            next if claimed.any? { |s, e| candidate.start < e && candidate.end > s }
+
             out << candidate
           end
         end

data/lib/vicary/redact.rb

@@ -148,6 +148,13 @@ module Vicary
       relation_refusal = options.fetch(:relation_refusal, true)
       title_relation_refusal = options.fetch(:title_relation_refusal, true)
 
+      # Adlib renders over the numbered restore map, so it refuses without one
+      # rather than ship placeholders under a setting that promised prose.
+      rendering = render_mode(options[:render])
+      if rendering == RENDER_ADLIB && !number_placeholders
+        raise ArgumentError, "adlib rendering needs local mode with numbered placeholders"
+      end
+
       minter = PlaceholderMinter.new(number: number_placeholders)
       return [text, 0, minter.assigned] if text.nil? || text.empty?
 
@@ -171,6 +178,14 @@ module Vicary
         n += count
       end
 
+      if rendering == RENDER_ADLIB
+        # A fourth element, so `masked, n, map = ...` callers keep working; the
+        # map is the adlib inverse, `{stand-in: original}`, as in the reference.
+        adlib = render_adlib(masked, minter.assigned, text,
+                             seed: resolve_adlib_seed(options[:adlib_seed]), identity: identity)
+        return [adlib.text, n, adlib.restore_map, adlib]
+      end
+
       [masked, n, minter.assigned]
     end
 

data/lib/vicary/version.rb

@@ -6,5 +6,5 @@ module Vicary
   # Shared across all three front doors on purpose: one detector, one number. A
   # gem 0.3.0 that corresponds to nothing on PyPI cannot be reasoned about, and
   # the parity claim is between *versions*, not between package names.
-  VERSION = "0.2.18"
+  VERSION = "0.3.0"
 end

data/lib/vicary.rb

@@ -45,3 +45,4 @@ require_relative "vicary/latency_baseline"
 require_relative "vicary/redact"
 require_relative "vicary/spans"
 require_relative "vicary/placeholders"
+require_relative "vicary/adlib"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vicary
 version: !ruby/object:Gem::Version
-  version: 0.2.18
+  version: 0.3.0
 platform: ruby
 authors:
 - Blake Thomas
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-22 00:00:00.000000000 Z
+date: 2026-11-04 00:00:00.000000000 Z
 dependencies: []
 description: |
   Finds the names a student writes about — classmates, teachers, relatives — and
@@ -25,9 +25,16 @@ files:
 - README.md
 - assets/MANIFEST.json
 - assets/notability.txt.gz
+- assets/pools/given.txt
+- assets/pools/org.txt
+- assets/pools/place.txt
+- assets/pools/school.txt
+- assets/pools/street.txt
+- assets/pools/surname.txt
 - assets/stop_words_never_capitalised.txt
 - assets/stop_words_sometimes_capitalised.txt
 - lib/vicary.rb
+- lib/vicary/adlib.rb
 - lib/vicary/asset.rb
 - lib/vicary/candidates.rb
 - lib/vicary/census.rb