omen 0.10.1 → 0.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9698c59cc037f0a9ccbe6b100af4a7137df0d26c8a54b3a8e5c37e9effe5e5e6
-  data.tar.gz: 792f03229094807c6ca995cc1271a199cc158db1f54ecfebee4a3e5db242712d
+  metadata.gz: 1133459de4acc00fce3144317e81c98e8d57b67d4afe0f8314ad962cc1178d7e
+  data.tar.gz: 5c377d7f308734e8707dde45b11621002960bd8a7976a29561f845a90b9dd81d
 SHA512:
-  metadata.gz: 4395ce363d33978256ce75d72d6495c873af06299c140f0a61bf0fc637bda94bde5cbb129744447a01b6603ebbcaf4fb5567920d3a32c859ba86c097ef206354
-  data.tar.gz: 8f5c0384edd2be88dcaacb5a60cb9256c4f8c2139a5fcb351a7eae9fce3ff5619bf5403a919c9ebb6e61fe64103c94bcc80a58d9f656552568862f34ac6f8e9c
+  metadata.gz: bd166680549604accb5254348eb325ed8a1109bdc24f85d045020df0d48b58057093ba56ead21669d4364a81fd4fd8517a9681391dee371de60ae10cded26f20
+  data.tar.gz: f68ed6d631c6d0be15627625b3f51613ec0e7fe334979ba0d02bf000f50d5e9c932db8978c03d2005e6676e89fd84185dce0919b3fae63673dbae80e7babf7b4

data/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this project will be documented in this file.
 For more information about changelogs, check [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.11.1 - 2026-10-14
+
+* [Fix] The sentences an answer reads as ship with the gem
+
+  0.11.0 kept them in `config/locales`, which the gem left out of what it packages, so a host
+  read `Translation missing: en.omen.figures` where an answer's figures belonged.
+
+## 0.11.0 - 2026-10-14
+
+* [Feature] An answer reads as words, and a reading as the turns of a chat
+
+  `answer.to_s` reads its figures out -- each name with its details in parentheses, the first
+  eight and `more` past them -- finishes its note where one figure answers it, says nothing
+  matched, that it ran long, or sorry where it failed. `reading.turns` pairs each question with
+  those words, `nil` while one is awaited. The sentences are `omen.*` keys a host rewords in its
+  own locale, and `config.rows_read_out` is how many figures are read out.
+
 ## 0.10.1 - 2026-10-14
 
 * [Change] The narrowed role is granted the connection's current schema rather than `public`,

data/INSTRUCTIONS.md

@@ -124,6 +124,7 @@ writes it with each line commented out, as the list of what there is to say.
 |---|---|
 | `narrow_role` | `'omen_inquirer'` |
 | `remembered` | `5`, the turns of a thread that travel with the next question |
+| `rows_read_out` | `8`, the rows of an answer its words read out before saying there are more |
 | `notes` | none, so the prompt says nothing about this app beyond its schema |
 
 ## What a host builds on top

data/README.md

@@ -18,7 +18,7 @@ statement returned is ever sent back.
 In your `Gemfile`, pinned to the current minor while this is still below 1.0:
 
 ```ruby
-gem 'omen', '~> 0.10.0'
+gem 'omen', '~> 0.11.0'
 ```
 
 Then four commands:
@@ -80,6 +80,12 @@ the statement Claude wrote, the rows it found, and which of their headers held a
 column. `rails g omen:pages` writes the pages that draw all of that, into your app, for you to
 keep or replace.
 
+An answer also reads as words: `answer.to_s` is its figures read out -- `Ada (Lovelace) and
+Alan.`, `Contacts who signed in: 2.` -- or its note where it has none, and sorry where it
+failed. `reading.turns` pairs each question with those words, `nil` while one is awaited, which
+is all a chat bubble needs. The sentences are `omen.*` keys in the gem's locale file, so a host
+rewords them in its own.
+
 ## Two kinds of reading
 
 `omen_readings` carries a `type`, so a subclass of `Omen::Reading` is a kind of reading rather

data/app/models/omen/answer.rb

@@ -1,6 +1,6 @@
 # What Claude said back: the prose, the statement it wrote, and the rows that statement found.
 class Omen::Answer < Omen.config.record
-  include Omen::Revealed, Omen::Spoken
+  include Omen::Revealed, Omen::Spoken, Omen::Worded
 
   # A \uXXXX escape that outlived JSON.parse, because Claude escaped the backslash of its own.
   UNICODE_ESCAPE = /\\u([0-9a-fA-F]{4})/

data/app/models/omen/reading.rb

@@ -18,6 +18,13 @@ class Omen::Reading < Omen.config.record
 
   # @return [String] the host's notes about its data, as this reading's asker is told them.
   def notes = Omen.config.notes
+
+  # @return [Array<Array>] each question asked and the answer said back, nil while it is awaited.
+  def turns
+    questions.includes(:answer).map do |question|
+      [ question.text, question.answer&.to_s || (I18n.t('omen.failed') if failed?) ]
+    end
+  end
 end
 
 ActiveSupport.run_load_hooks :omen_reading, Omen::Reading

data/app/models/omen/worded.rb

@@ -0,0 +1,42 @@
+# Extends Omen::Answer with the words it is read out in, which a host rewords in its own locale.
+module Omen::Worded extend ActiveSupport::Concern
+  # @return [String] the answer in words: its figures read out, its note where it has none.
+  def to_s
+    return I18n.t('omen.failed') if error.present?
+
+    [ said, (I18n.t('omen.ran_long') if cut_off?) ].compact.join ' '
+  end
+
+private
+
+  def said
+    if sql.blank?
+      note.squish
+    else
+      read_out shown.first(Omen.config.rows_read_out)
+    end
+  end
+
+  def read_out(rows)
+    if rows.empty?
+      I18n.t 'omen.nothing'
+    elsif rows.one?
+      I18n.t 'omen.one', note: note.squish.delete_suffix('.'), figure: figure(rows.sole)
+    else
+      figures = [ *rows.map { |row| figure row }, more(rows) ].compact
+      I18n.t 'omen.figures', list: figures.to_sentence
+    end
+  end
+
+  def more(rows) = (I18n.t 'omen.more' if shown.size > rows.size || truncated?)
+
+  def figure(row)
+    values = row.values.compact_blank.map(&:to_s)
+
+    if values.one?
+      values.first
+    else
+      I18n.t 'omen.figure', name: values.first, details: values.drop(1).join(', ')
+    end
+  end
+end

data/config/locales/omen.en.yml

@@ -0,0 +1,9 @@
+en:
+  omen:
+    failed: Sorry, I cannot answer that question.
+    nothing: Nothing matched that.
+    ran_long: That one ran long. Ask for less at a time.
+    more: more
+    one: "%{note}: %{figure}."
+    figures: "%{list}."
+    figure: "%{name} (%{details})"

data/lib/generators/omen/install/templates/omen.rb

@@ -23,6 +23,9 @@ Omen.configure do |config|
   # there are more without counting them.
   # config.maximum_rows = 100
 
+  # How many of those rows an answer's words read out before saying there are more.
+  # config.rows_read_out = 8
+
   # How many turns of a thread travel with the next question. A thread nobody clears would
   # otherwise carry its whole history into each one, and be charged for it again each time.
   # config.remembered = 5

data/lib/omen/config.rb

@@ -15,6 +15,9 @@ module Omen
     # How many rows of one answer a page will show.
     attr_accessor :maximum_rows
 
+    # How many of those rows an answer's words read out before saying there are more.
+    attr_accessor :rows_read_out
+
     # How many turns of a thread travel with the next question.
     attr_accessor :remembered
 
@@ -29,6 +32,7 @@ module Omen
       @narrow_role = 'omen_inquirer'
       @claude_model = 'claude-opus-5'
       @maximum_rows = 100
+      @rows_read_out = 8
       @remembered = 5
       @schema_path = 'db/schema.rb'
     end

data/lib/omen/version.rb

@@ -1,4 +1,4 @@
 module Omen
   # The version of this gem, as RubyGems knows it.
-  VERSION = '0.10.1'
+  VERSION = '0.11.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omen
 version: !ruby/object:Gem::Version
-  version: 0.10.1
+  version: 0.11.1
 platform: ruby
 authors:
 - Claudio Baccigalupo
@@ -95,6 +95,8 @@ files:
 - app/models/omen/schema.rb
 - app/models/omen/spoken.rb
 - app/models/omen/stated.rb
+- app/models/omen/worded.rb
+- config/locales/omen.en.yml
 - db/migrate/20260821120000_create_omen_readings.rb
 - db/migrate/20260821120001_create_omen_questions.rb
 - db/migrate/20260821120002_create_omen_answers.rb