inquirex 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17d01981ef4e69be2150f96efb297012bbfb2af2b3128ba6aea45f39c9aec821
-  data.tar.gz: '0298dbc81566df2384ab1c634303f4504313e6a35a091b559f10ffb668508cb5'
+  metadata.gz: 5457c529512019dbfcb838eb1a607d933d85cad7a2edc926bd0049eca271f2f0
+  data.tar.gz: f561ac674e088508c2bb33726016660dc5a29cbbeb085e17ec84de8833c45859
 SHA512:
-  metadata.gz: c3ddd23f48c9781b11e2692690bf8dfd1dc5b3e764b089167a71053f74950fd2f18465aadc548364dd660c8db8599c092c46eba21eb9f7df80e429d9633210f2
-  data.tar.gz: f53e0183422971270e3db8f069206aa8f23d83e8439a6738922d878da5066937693a4c8303a6786cd8347aef4ab6ae3a228acca583cb0a3861616f7ed6e82c37
+  metadata.gz: be941ae3435a8e114dce7234477afb5d29e2624f7ddf8ed07fe8118d23b031390dd4c59610251f8419469765e4c6db5bc5413522b9f1befcc5e218e95b295513
+  data.tar.gz: 831876215c0ee5cd29d7bf72549d9a430633b3dafe6f154e813df2891381bc9d269ddddbcef117a6b86697c32ae4708fdf30faf0a2d8f18e259b3f933f76c1a2

data/README.md

@@ -381,6 +381,23 @@ Behavior:
 - Use `finished?` to detect completion
 - Use `total(:price)` / `totals` to read running totals
 - Use `to_state` / `.from_state` for persistence/resume (totals included)
+- Use `prefill!(hash)` to merge externally-supplied answers into the state,
+  e.g. fields extracted by an LLM from a free-text answer (see
+  [inquirex-llm](#extension-gems)). Existing answers are preserved; `nil`
+  and empty values are ignored so they don't spuriously satisfy
+  `not_empty` rules. The engine auto-advances past any newly-skippable step.
+
+```ruby
+engine = Inquirex::Engine.new(definition)
+engine.answer("I'm MFJ with two kids in California.") # free-text :describe
+
+# Step is now :extracted (a clarify node); adapter returns a Hash.
+result = adapter.call(engine.current_step, engine.answers)
+engine.answer(result)           # store under the clarify step's id
+engine.prefill!(result)         # splat into top-level answers
+# Downstream :filing_status, :dependents, :state are now auto-skipped by
+# `skip_if not_empty(:filing_status)` etc.
+```
 
 ### Validation Adapter
 

data/docs/badges/coverage_badge.svg

@@ -15,7 +15,7 @@
   <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
     <text x="31.5" y="15" fill="#010101" fill-opacity=".3">coverage</text>
     <text x="31.5" y="14">coverage</text>
-    <text x="80" y="15" fill="#010101" fill-opacity=".3">94%</text>
-    <text x="80" y="14">94%</text>
+    <text x="80" y="15" fill="#010101" fill-opacity=".3">95%</text>
+    <text x="80" y="14">95%</text>
   </g>
 </svg>

data/lib/inquirex/engine.rb

@@ -74,6 +74,33 @@ module Inquirex
       advance_step
     end
 
+    # Merges a hash of { step_id => value } into the top-level answers without
+    # clobbering answers the user has already provided. Used by LLM clarify
+    # steps to populate downstream answers from free-text extraction so that
+    # `skip_if not_empty(:id)` rules on later steps will fire.
+    #
+    # Nil/empty values in the hash are ignored so that "unknown" LLM outputs
+    # don't spuriously satisfy `not_empty` rules.
+    #
+    # If the engine's current step becomes skippable as a result of the prefill,
+    # it auto-advances past it.
+    #
+    # @param hash [Hash] answers keyed by step id
+    # @return [Hash] the updated answers
+    def prefill!(hash)
+      return @answers unless hash.is_a?(Hash)
+
+      hash.each do |key, value|
+        next if value.nil?
+        next if value.respond_to?(:empty?) && value.empty?
+
+        sym = key.to_sym
+        @answers[sym] = value unless @answers.key?(sym)
+      end
+      skip_if_needed unless finished?
+      @answers
+    end
+
     # Serializable state snapshot for persistence or resumption.
     #
     # @return [Hash]

data/lib/inquirex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Inquirex
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: inquirex
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Konstantin Gredeskoul
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
@@ -18,8 +18,7 @@ description: Inquirex lets you define multi-step questionnaires as directed grap
   immutable definitions.
 email:
 - kigster@gmail.com
-executables:
-- inquirex
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
@@ -33,7 +32,6 @@ files:
 - README.md
 - Rakefile
 - docs/badges/coverage_badge.svg
-- exe/inquirex
 - justfile
 - lefthook.yml
 - lib/inquirex.rb

data/exe/inquirex

@@ -1,3 +0,0 @@
-#!/usr/bin/env ruby
-
-require "inquirex"