inquirex 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f99f7adba97c905c55490b57467fe062251719bbb98d698fe49e6dd04360fcf7
-  data.tar.gz: 2c6850590153b96ee376ddaa0314c2de3cf729f6ea2d7c8f3d0ccb20d2359683
+  metadata.gz: 3422d46566a55c973dc712fb60918cde34029d3dc739e36bb1eb2c40110f1f25
+  data.tar.gz: eb6e54e12a407b21547ac97ca7153b93af516713c0dbcaa83a2323f909f8f816
 SHA512:
-  metadata.gz: 18b95d28461f971551997bb177c6ead5c4165562f1d627460d58656440a0884bf0972eef2d97a31e3883f34720349be82e24e2fa567b7181eea0f14361182355
-  data.tar.gz: ed93da41fe8d2f66098b0165224e472d794d6f7ab9313dd8ec9a8a80b0d299ef5623d957361d83a27680b1ce3c025dd294fc6690c855c02a32df90348726718c
+  metadata.gz: 42b3c45e598ebadec67d48e251605e74022cfe1ba0923c21b5998b0c0c2ef8005f2895e43c501dfd9a8613d05821a95653330c5395ff7755fa1892a74761873c
+  data.tar.gz: c85a9f013fb304ddfc7cbb9742a24167c7da7cefe18fa83425cfc83f1ac5184eeb7960a9ee3592d95ebd82890f7b9568aaea2b1eb488d8840a17106cbe091f3f

data/CHANGELOG.md

@@ -3,20 +3,12 @@
 ## [0.6.0] - 2026-07-19
 
 - Post-completion `action` DSL verb with an extensible effect registry
-- `send_email` effect: builds `Mail::Message` objects (multipart text/HTML)
-  from `{{field}}` templates into `Answers#outbox`; delivery is the host
-  application's responsibility. The `mail` gem is a soft dependency.
+- `send_email` effect: builds `Mail::Message` objects (multipart text/HTML) from `{{field}}` templates into `Answers#outbox`; delivery is the host application's responsibility. The `mail` gem is a soft dependency.
 - `run { |answers, outbox| ... }` escape-hatch effect (stripped from JSON)
-- `webhook` effect: POSTs the answers envelope to a static https URL whose
-  host must be covered by the new top-level `allowed_domains` declaration;
-  enforcement runs in `Definition#validate!`, so tampered JSON definitions
-  fail at rehydration
+- `webhook` effect: POSTs the answers envelope to a static https URL whose host must be covered by the new top-level `allowed_domains` declaration; enforcement runs in `Definition#validate!`, so tampered JSON definitions fail at rehydration
 - `Inquirex::Actions::Runner` and `Inquirex::Actions.run(definition, answers)`
 - Actions serialize to/from JSON with their rule gates
-- `CompletionMetadata` (OpenStruct; `engine` and `engine_version` required)
-  stamped by the engine at flow completion, enrichable by front-ends via the
-  new `Engine#after_completion` hook, persisted in engine state, and merged
-  into answers by `Engine#answers_with_metadata`
+- `CompletionMetadata` (OpenStruct; `engine` and `engine_version` required) stamped by the engine at flow completion, enrichable by front-ends via the new `Engine#after_completion` hook, persisted in engine state, and merged into answers by `Engine#answers_with_metadata`
 
 ## [0.1.0] - 2026-04-13
 

data/README.md

@@ -31,7 +31,7 @@ It provides a rich DSL for creating dynamic user intake forms, with complexity r
 >
 > For technically inclined, Inquirex turns user forms into a directed graph, where nodes are either questions or statements (or UI transitions), while edges are AST-based logical conditions that can be stacked and joined in arbitrarily complex ways, allowing you to move from one question to any other based on the previous answer. See the details below.
 
-***Don't want to deal with figuring it out? Head to [Qualified.At](https://qualified.at/onboarding) and walk through the demo onboarding form, that exists specifically to show you how quickly you can have the same conceptually on your site, tailored to YOUR users.***
+***Don't want to deal with figuring it out? Head to [Qualified.At](https://qualified.at) and walk through the demo onboarding form, that exists specifically to show you how quickly you can have the same conceptually on your site, tailored to YOUR users.***
 
 ## Summary
 
@@ -435,11 +435,7 @@ 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.
+- 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)
@@ -468,10 +464,7 @@ engine = Inquirex::Engine.new(definition, validator: my_validator)
 
 ## Completion Metadata
 
-When a flow finishes, the engine guarantees a `CompletionMetadata` — an
-OpenStruct describing how the answers were collected. Only `engine` and
-`engine_version` are required members; rendering front-ends attach richer
-environment details from an `after_completion` hook:
+When a flow finishes, the engine guarantees a `CompletionMetadata` — an OpenStruct describing how the answers were collected. Only `engine` and `engine_version` are required members; rendering front-ends attach richer environment details from an `after_completion` hook:
 
 ```ruby
 engine.after_completion do |eng|
@@ -485,21 +478,11 @@ engine.after_completion do |eng|
 end
 ```
 
-If no hook supplies one, the engine stamps the minimal core version
-(`engine: "inquirex"`, `engine_version: Inquirex::VERSION`). The metadata
-persists through `Engine#to_state` / `Engine.from_state`, and
-`engine.answers_with_metadata` merges it into the answers hash under
-`:completion_metadata` — which also makes it available to post-completion
-actions: webhook payloads carry it, and email templates can interpolate
-`{{completion_metadata.engine}}`.
+If no hook supplies one, the engine stamps the minimal core version (`engine: "inquirex"`, `engine_version: Inquirex::VERSION`). The metadata persists through `Engine#to_state` / `Engine.from_state`, and `engine.answers_with_metadata` merges it into the answers hash under `:completion_metadata` — which also makes it available to post-completion actions: webhook payloads carry it, and email templates can interpolate `{{completion_metadata.engine}}`.
 
 ## Post-Completion Actions
 
-After all questions are answered, `action` declarations run server-side with
-the collected answers. The flagship effect is `send_email`, which **builds**
-`Mail::Message` objects (the same object ActionMailer wraps) and attaches them
-to `answers.outbox` — **nothing is delivered**; the host application decides
-how and when to send.
+After all questions are answered, `action` declarations run server-side with the collected answers. The flagship effect is `send_email`, which **builds** `Mail::Message` objects (the same object ActionMailer wraps) and attaches them to `answers.outbox` — **nothing is delivered**; the host application decides how and when to send.
 
 ```ruby
 Inquirex.define id: "tax-intake-2025" do
@@ -554,31 +537,14 @@ end
 
 Key semantics:
 
-- **Templating is `{{field}}` interpolation only** — dot-notation keys resolved
-  against `Answers#to_flat_h`, deliberately inert (no code execution), so
-  definitions stored in a database render safely. Values interpolated into
-  `html:` bodies are HTML-escaped automatically; `text:` bodies stay verbatim.
-  The built-in `{{answers_summary}}` expands to all collected answers.
-- **`if:` gates** reuse the serializable rule AST (`not_empty(:email)`, ...).
-  A false rule records `:skipped` — declare no actions (or gate them) when a
-  flow should only save answers.
-- **`run { |answers, outbox| ... }`** is the full-Ruby escape hatch; like all
-  lambdas it is stripped from JSON.
-- **Failures are isolated**: a raising effect records `:failed` in
-  `outbox.results` and never blocks other actions.
+- **Templating is `{{field}}` interpolation only** — dot-notation keys resolved against `Answers#to_flat_h`, deliberately inert (no code execution), so definitions stored in a database render safely. Values interpolated into `html:` bodies are HTML-escaped automatically; `text:` bodies stay verbatim. The built-in `{{answers_summary}}` expands to all collected answers.
+- **`if:` gates** reuse the serializable rule AST (`not_empty(:email)`, ...). A false rule records `:skipped` — declare no actions (or gate them) when a flow should only save answers.
+- **`run { |answers, outbox| ... }`** is the full-Ruby escape hatch; like all lambdas it is stripped from JSON.
+- **Failures are isolated**: a raising effect records `:failed` in `outbox.results` and never blocks other actions.
 - **Images** in HTML bodies must be external URLs; attachments are unsupported.
-- The `mail` gem is a soft dependency, needed only when a message is built
-  (Rails hosts already have it via ActionMailer).
-- **`webhook url:`** POSTs `{"answers": {...}}` as JSON to a static URL. The
-  URL's host must be covered by `allowed_domains`, declared at the top of the
-  definition so the flow's egress surface is auditable at a glance. The check
-  runs inside `Definition.new` — a JSON definition whose webhook URL was
-  tampered with fails at *rehydration*, before anything executes. Also
-  enforced: https only (plain http just for localhost), no userinfo, no
-  `{{field}}` templates in URLs (the destination must be static), redirects
-  are not followed, and non-2xx responses record `:failed`.
-- Effects are extensible: `Inquirex::Actions.register(:save_record, MyEffect)`
-  gives a new verb both DSL and JSON wire support.
+- The `mail` gem is a soft dependency, needed only when a message is built (Rails hosts already have it via ActionMailer).
+- **`webhook url:`** POSTs `{"answers": {...}}` as JSON to a static URL. The URL's host must be covered by `allowed_domains`, declared at the top of the definition so the flow's egress surface is auditable at a glance. The check runs inside `Definition.new` — a JSON definition whose webhook URL was tampered with fails at *rehydration*, before anything executes. Also enforced: https only (plain http just for localhost), no userinfo, no `{{field}}` templates in URLs (the destination must be static), redirects are not followed, and non-2xx responses record `:failed`.
+- Effects are extensible: `Inquirex::Actions.register(:save_record, MyEffect)` gives a new verb both DSL and JSON wire support.
 
 ## Serialization
 
@@ -597,11 +563,8 @@ Serialized structure includes:
 - Steps and transitions
 - Rule AST payloads
 - Widget hints
-- Post-completion actions (`actions`) with their rules and effects; `run`
-  blocks are stripped, and an action left with no serializable effects is
-  omitted entirely
-- The `allowed_domains` egress allowlist, re-enforced against webhook URLs
-  every time a definition is rehydrated
+- Post-completion actions (`actions`) with their rules and effects; `run` blocks are stripped, and an action left with no serializable effects is omitted entirely
+- The `allowed_domains` egress allowlist, re-enforced against webhook URLs every time a definition is rehydrated
 
 Important serialization details:
 

data/lib/inquirex/engine/state_serializer.rb

@@ -11,6 +11,7 @@ module Inquirex
         history:             ->(v) { Array(v).map { |e| e&.to_sym } },
         answers:             ->(v) { symbolize_answers(v) },
         totals:              ->(v) { symbolize_answers(v) },
+        suggestions:         ->(v) { symbolize_answers(v) },
         completion_metadata: ->(v) { symbolize_answers(v) }
       }.freeze
 

data/lib/inquirex/engine.rb

@@ -21,6 +21,15 @@ module Inquirex
     # @return [CompletionMetadata, nil] nil until the flow finishes
     attr_accessor :completion_metadata
 
+    # Answer suggestions produced by prefill! for multi-select steps, keyed by
+    # step id. A suggestion pre-populates the step's choices in a renderer but
+    # — unlike an answer — never satisfies skip_if rules: multi-select
+    # extraction is treated as a hint the user confirms and may extend, not a
+    # deterministic fact. Cleared per step once the user answers it.
+    #
+    # @return [Hash{Symbol => Array}]
+    attr_reader :suggestions
+
     # Exceptions raised by after_completion hooks, in the order they were
     # raised. Hooks are isolated from one another, so a raising hook is
     # recorded here rather than propagated — callers that care can inspect
@@ -41,6 +50,7 @@ module Inquirex
       @completion_metadata = nil
       @after_completion_hooks = []
       @completion_hook_errors = []
+      @suggestions = {}
       @history << @current_step_id
       skip_display_steps_if_needed
     end
@@ -81,6 +91,7 @@ module Inquirex
       raise Errors::ValidationError, "Validation failed: #{result.errors.join(", ")}" unless result.valid?
 
       @answers[@current_step_id] = value
+      @suggestions.delete(@current_step_id)
       apply_accumulations(current_step, value)
       advance_step
     end
@@ -115,12 +126,28 @@ module Inquirex
         next if value.respond_to?(:empty?) && value.empty?
 
         sym = key.to_sym
-        @answers[sym] = value unless @answers.key?(sym)
+        if multi_select_step?(sym)
+          # Multi-select extraction is a hint, not a fact: the user may have
+          # more selections in mind than the text revealed. Record it as a
+          # suggestion so renderers pre-check the choices while the question
+          # is still asked; skip_if rules see no answer and do not fire.
+          @suggestions[sym] = Array(value) unless @answers.key?(sym)
+        else
+          @answers[sym] = value unless @answers.key?(sym)
+        end
       end
       skip_if_needed unless finished?
       @answers
     end
 
+    # The prefill suggestion for a step, or nil when none was recorded.
+    #
+    # @param step_id [Symbol, String] step id
+    # @return [Array, nil] suggested selections for a multi-select step
+    def suggestion_for(step_id)
+      @suggestions[step_id.to_sym]
+    end
+
     # Registers a hook to run when the flow finishes. The block receives the
     # engine; front-ends typically use it to attach a rich
     # completion_metadata (host, user, ips, terminal, ...). Optional — after
@@ -163,6 +190,7 @@ module Inquirex
         answers:             @answers,
         history:             @history,
         totals:              @totals,
+        suggestions:         @suggestions,
         completion_metadata: @completion_metadata&.to_h
       }
     end
@@ -202,6 +230,16 @@ module Inquirex
       @completion_metadata = CompletionMetadata.from_h(state[:completion_metadata])
       @after_completion_hooks = []
       @completion_hook_errors = []
+      @suggestions = state[:suggestions] || {}
+    end
+
+    # Whether +step_id+ names a multi-select step in the definition. Unknown
+    # ids (e.g. an extract schema field that matches no step) are not.
+    #
+    # @param step_id [Symbol]
+    # @return [Boolean]
+    def multi_select_step?(step_id)
+      @definition.step_ids.include?(step_id) && @definition.step(step_id).type == :multi_enum
     end
 
     def init_totals

data/lib/inquirex/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inquirex
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Konstantin Gredeskoul
@@ -36,23 +36,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".relaxed_rubocop.yml"
-- ".rub"
-- ".ruby-version"
-- ".secrets.baseline"
-- Brewfile
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- Rakefile
-- docs/badges/coverage_badge.svg
-- examples/01_readme_example.rb
-- examples/02_readme_mermaid.png
-- examples/02_readme_mermaid.rb
-- examples/03_send_email_actions.rb
-- examples/README.md
-- justfile
-- lefthook.yml
+- lib/.DS_Store
 - lib/inquirex.rb
 - lib/inquirex/accumulator.rb
 - lib/inquirex/actions.rb
@@ -92,7 +79,6 @@ files:
 - lib/inquirex/version.rb
 - lib/inquirex/widget_hint.rb
 - lib/inquirex/widget_registry.rb
-- sig/inquirex.rbs
 homepage: https://github.com/inquirex/inquirex
 licenses:
 - MIT

data/.relaxed_rubocop.yml

@@ -1,153 +0,0 @@
-# Relaxed.Ruby.Style
-## Version 2.5
-
-Style/Alias:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylealias
-
-Style/AsciiComments:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styleasciicomments
-
-Style/BeginBlock:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylebeginblock
-
-Style/BlockDelimiters:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styleblockdelimiters
-
-Style/CommentAnnotation:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylecommentannotation
-
-Style/Documentation:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styledocumentation
-
-Layout/DotPosition:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#layoutdotposition
-
-Style/DoubleNegation:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styledoublenegation
-
-Style/EndBlock:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styleendblock
-
-Style/FormatString:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styleformatstring
-
-Style/IfUnlessModifier:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styleifunlessmodifier
-
-Style/Lambda:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylelambda
-
-Style/ModuleFunction:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylemodulefunction
-
-Style/MultilineBlockChain:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylemultilineblockchain
-
-Style/NegatedIf:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylenegatedif
-
-Style/NegatedWhile:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylenegatedwhile
-
-Style/NumericPredicate:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylenumericpredicate
-
-Style/ParallelAssignment:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styleparallelassignment
-
-Style/PercentLiteralDelimiters:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylepercentliteraldelimiters
-
-Style/PerlBackrefs:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styleperlbackrefs
-
-Style/Semicolon:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylesemicolon
-
-Style/SignalException:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylesignalexception
-
-Style/SingleLineBlockParams:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylesinglelineblockparams
-
-Style/SingleLineMethods:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylesinglelinemethods
-
-Layout/SpaceBeforeBlockBraces:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#layoutspacebeforeblockbraces
-
-Layout/SpaceInsideParens:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#layoutspaceinsideparens
-
-Style/SpecialGlobalVars:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylespecialglobalvars
-
-Style/StringLiterals:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylestringliterals
-
-Style/TrailingCommaInArguments:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styletrailingcommainarguments
-
-Style/TrailingCommaInArrayLiteral:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styletrailingcommainarrayliteral
-
-Style/TrailingCommaInHashLiteral:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#styletrailingcommainhashliteral
-
-Style/SymbolArray:
-  Enabled: false
-  StyleGuide: http://relaxed.ruby.style/#stylesymbolarray
-
-Style/WhileUntilModifier:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylewhileuntilmodifier
-
-Style/WordArray:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#stylewordarray
-
-Lint/AmbiguousRegexpLiteral:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#lintambiguousregexpliteral
-
-Lint/AssignmentInCondition:
-  Enabled: false
-  StyleGuide: https://relaxed.ruby.style/#lintassignmentincondition
-
-Layout/LineLength:
-  Enabled: false
-
-Metrics:
-  Enabled: false
-

data/.ruby-version

@@ -1 +0,0 @@
-4.0.5

data/.secrets.baseline

@@ -1,127 +0,0 @@
-{
-  "version": "1.5.0",
-  "plugins_used": [
-    {
-      "name": "ArtifactoryDetector"
-    },
-    {
-      "name": "AWSKeyDetector"
-    },
-    {
-      "name": "AzureStorageKeyDetector"
-    },
-    {
-      "name": "Base64HighEntropyString",
-      "limit": 4.5
-    },
-    {
-      "name": "BasicAuthDetector"
-    },
-    {
-      "name": "CloudantDetector"
-    },
-    {
-      "name": "DiscordBotTokenDetector"
-    },
-    {
-      "name": "GitHubTokenDetector"
-    },
-    {
-      "name": "GitLabTokenDetector"
-    },
-    {
-      "name": "HexHighEntropyString",
-      "limit": 3.0
-    },
-    {
-      "name": "IbmCloudIamDetector"
-    },
-    {
-      "name": "IbmCosHmacDetector"
-    },
-    {
-      "name": "IPPublicDetector"
-    },
-    {
-      "name": "JwtTokenDetector"
-    },
-    {
-      "name": "KeywordDetector",
-      "keyword_exclude": ""
-    },
-    {
-      "name": "MailchimpDetector"
-    },
-    {
-      "name": "NpmDetector"
-    },
-    {
-      "name": "OpenAIDetector"
-    },
-    {
-      "name": "PrivateKeyDetector"
-    },
-    {
-      "name": "PypiTokenDetector"
-    },
-    {
-      "name": "SendGridDetector"
-    },
-    {
-      "name": "SlackDetector"
-    },
-    {
-      "name": "SoftlayerDetector"
-    },
-    {
-      "name": "SquareOAuthDetector"
-    },
-    {
-      "name": "StripeDetector"
-    },
-    {
-      "name": "TelegramBotTokenDetector"
-    },
-    {
-      "name": "TwilioKeyDetector"
-    }
-  ],
-  "filters_used": [
-    {
-      "path": "detect_secrets.filters.allowlist.is_line_allowlisted"
-    },
-    {
-      "path": "detect_secrets.filters.common.is_ignored_due_to_verification_policies",
-      "min_level": 2
-    },
-    {
-      "path": "detect_secrets.filters.heuristic.is_indirect_reference"
-    },
-    {
-      "path": "detect_secrets.filters.heuristic.is_likely_id_string"
-    },
-    {
-      "path": "detect_secrets.filters.heuristic.is_lock_file"
-    },
-    {
-      "path": "detect_secrets.filters.heuristic.is_not_alphanumeric_string"
-    },
-    {
-      "path": "detect_secrets.filters.heuristic.is_potential_uuid"
-    },
-    {
-      "path": "detect_secrets.filters.heuristic.is_prefixed_with_dollar_sign"
-    },
-    {
-      "path": "detect_secrets.filters.heuristic.is_sequential_string"
-    },
-    {
-      "path": "detect_secrets.filters.heuristic.is_swagger_file"
-    },
-    {
-      "path": "detect_secrets.filters.heuristic.is_templated_secret"
-    }
-  ],
-  "results": {},
-  "generated_at": "2026-04-13T21:29:03Z"
-}

data/Brewfile

@@ -1,7 +0,0 @@
-# Please run `brew bundle` before running `lefthook install`
-
-brew 'lefthook'
-brew 'codespell'
-brew 'mdformat'
-brew 'detect-secrets'
-

data/Rakefile

@@ -1,36 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-require "timeout"
-require "yard"
-
-def shell(*args)
-  puts "running: #{args.join(" ")}"
-  system(args.join(" "))
-end
-
-task :clean do
-  shell("rm -rf pkg/ tmp/ coverage/ doc/ ")
-end
-
-task gem: [:build] do
-  shell("gem install pkg/*")
-end
-
-task permissions: [:clean] do
-  shell("chmod -v o+r,g+r * */* */*/* */*/*/* */*/*/*/* */*/*/*/*/*")
-  shell("find . -type d -exec chmod o+x,g+x {} \\;")
-end
-
-task build: :permissions
-
-YARD::Rake::YardocTask.new(:doc) do |t|
-  t.files = %w[lib/**/*.rb exe/*.rb - README.md LICENSE.txt CHANGELOG.md]
-  t.options.unshift("--title", '"FlowEngine — DSL + AST for buildiong complex flows in Ruby."')
-  t.after = -> { exec("open doc/index.html") } if RUBY_PLATFORM =~ /darwin/
-end
-
-RSpec::Core::RakeTask.new(:spec)
-
-task default: :spec

data/docs/badges/coverage_badge.svg

@@ -1,21 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg xmlns="http://www.w3.org/2000/svg" width="99" height="20">
-  <linearGradient id="b" x2="0" y2="100%">
-    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
-    <stop offset="1" stop-opacity=".1"/>
-  </linearGradient>
-  <mask id="a">
-    <rect width="99" height="20" rx="3" fill="#fff"/>
-  </mask>
-  <g mask="url(#a)">
-    <path fill="#555" d="M0 0h63v20H0z"/>
-    <path fill="#4c1" d="M63 0h36v20H63z"/>
-    <path fill="url(#b)" d="M0 0h99v20H0z"/>
-  </g>
-  <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">96%</text>
-    <text x="80" y="14">96%</text>
-  </g>
-</svg>

data/examples/01_readme_example.rb

@@ -1,55 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "bundler/setup"
-require "inquirex"
-
-DEFINITION = Inquirex.define id: "tax-intake-2025", version: "1.0.0" do
-  meta title: "Tax Preparation Intake", subtitle: "Let's understand your situation"
-  start :filing_status
-
-  ask :filing_status do
-    type :enum
-    question "What is your filing status?"
-    options single: "Single", married_jointly: "Married Filing Jointly"
-    widget target: :desktop, type: :radio_group, columns: 2
-    widget target: :mobile,  type: :dropdown
-    transition to: :dependents
-  end
-
-  ask :dependents do
-    type :integer
-    question "How many dependents?"
-    default 0
-    transition to: :business_income
-  end
-
-  confirm :business_income do
-    question "Do you have business income?"
-    transition to: :business_count, if_rule: equals(:business_income, true)
-    transition to: :done
-  end
-
-  ask :business_count do
-    type :integer
-    question "How many businesses?"
-    transition to: :done
-  end
-
-  say :done do
-    text "Thanks for completing the intake."
-  end
-end
-
-engine = Inquirex::Engine.new(DEFINITION)
-
-engine.answer("single") # filing_status
-engine.answer(2)        # dependents
-engine.answer(false)    # business_income
-engine.advance          # done (display step)
-engine.finished?        # => true
-
-if __FILE__ == $0
-  require 'json'
-  puts JSON.pretty_generate(DEFINITION.to_h)
-end

data/examples/02_readme_mermaid.rb

@@ -1,36 +0,0 @@
-#!/usr/bin/env ruby
-
-require_relative '01_readme_example'
-require 'inquirex'
-require 'stringio'
-
-output = StringIO.new
-exporter = Inquirex::Graph::MermaidExporter.new(DEFINITION)
-output << exporter.export
-
-source = <<~HTML
-  <html>
-    <head>
-      <meta charset="utf-8">
-    </head>
-    <body>
-    <meta charset="utf-8">
-    <div class="mermaid">
-      #{output.string}
-    </div>
-    <script type="module">
-      import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
-      mermaid.initialize({ startOnLoad: true });
-    </script>
-  </html>
-HTML
-
-if __FILE__ == $0
-  File.write('mermaid.html', source)
-  system("open mermaid.html")
-  sleep 10
-
-  at_exit do
-    File.delete('mermaid.html')
-  end
-end

data/examples/03_send_email_actions.rb

@@ -1,97 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# Example 03: Post-completion actions building emails into the outbox.
-#
-# The `action` verb runs server-side after the flow finishes. send_email
-# builds Mail::Message objects — nothing is delivered here; a host Rails app
-# would iterate answers.outbox and deliver via its own ActionMailer config.
-#
-# Run:
-#   bundle exec ruby examples/03_send_email_actions.rb
-
-require "bundler/setup"
-require "inquirex"
-
-DEFINITION = Inquirex.define id: "lead-intake", version: "1.0.0" do
-  # Egress allowlist: webhook effects may only POST to these hosts.
-  allowed_domains "*.agentica.group"
-
-  meta title: "Lead Intake", subtitle: "Tell us about your project"
-  start :name
-
-  ask :name do
-    type :string
-    question "What is your name?"
-    transition to: :email
-  end
-
-  ask :email do
-    type :email
-    question "Where can we reach you? (leave blank to skip the receipt)"
-    transition to: :budget
-  end
-
-  ask :budget do
-    type :currency
-    question "What is your approximate budget?"
-  end
-
-  # Sent only when the visitor left an email address.
-  action :client_receipt, if: not_empty(:email) do
-    send_email to:      "{{email}}",
-      from:    "forms@agentica.group",
-      subject: "Thanks {{name}} — we got your inquiry",
-      text:    <<~TEXT,
-        Hi {{name}},
-
-        We received your answers and will reply within one business day.
-
-        {{answers_summary}}
-      TEXT
-      html:    <<~HTML
-        <p>Hi {{name}},</p>
-        <p>We received your answers and will reply within one business day.</p>
-        {{answers_summary}}
-      HTML
-  end
-
-  # Always notify the site owner, and demonstrate the Ruby escape hatch.
-  action :admin_alert do
-    send_email to: "owner@agentica.group",
-      from: "forms@agentica.group",
-      subject: "New lead: {{name}} (budget {{budget}})",
-      html: "{{answers_summary}}"
-    run { |answers, _outbox| puts ">> run{} saw budget: #{answers.budget}" }
-  end
-
-  # Webhook to an allowed_domains host. Gated by an always-false rule so this
-  # example runs offline — it records :skipped instead of POSTing. Drop the
-  # if: to exercise it for real.
-  action :crm_push, if: equals(:name, "__network_demo__") do
-    webhook url: "https://hooks.agentica.group/inquirex",
-      headers: { "X-Api-Key" => "demo" }
-  end
-end
-
-answers = Inquirex::Actions.run(
-  DEFINITION,
-  name:   "Ada Lovelace",
-  email:  "ada@lovelace.io",
-  budget: 12_500.00
-)
-
-puts "Built #{answers.outbox.size} message(s):"
-answers.outbox.each do |mail|
-  puts "-" * 60
-  puts "To:      #{mail.to.join(", ")}"
-  puts "Subject: #{mail.subject}"
-  puts "Parts:   #{mail.multipart? ? "text + html" : mail.content_type}"
-end
-
-puts "-" * 60
-puts "Results: #{answers.outbox.results.map { |r| "#{r.action_id}=#{r.status}" }.join(", ")}"
-
-# The definition (rules and all) round-trips through JSON — run{} is stripped:
-restored = Inquirex::Definition.from_json(DEFINITION.to_json)
-puts "Actions after JSON round-trip: #{restored.actions.map(&:id).inspect}"

data/examples/README.md

@@ -1,33 +0,0 @@
-# Examples
-
-This folder contains just a couple examples to demonstrate the API and the functionality.
-
-For a fuller list of more comprehensive examples, please see the [examples in the `inquirex-tty` gem](https://github.com/inquirex/inquirex-tty/tree/main/examples).
-
-## Running Examples
-
-These examples are meant to be run as executables from the root level of the gem folder.
-
-### First Example
-
-This example should print to stdout the DSL definition in JSON:
-
-```bash
-# First example — creates a DSL definition and prints it to stdout in JSON format
-./examples/01_readme_example.rb | jq
-```
-
-### Second Example
-
-This is a more interesting example. It builds on the first, takes that definition and uses the mermaid converter to write a tiny HTML file with a mermaid diagram inside, which represents the definition defined in the first file.
-
-```bash
-# creates a mermaid.html file at the root of the project
-# opens the browser with the file and waits 10 seconds
-# deletes the HTML file and exits
-./examples/02_readme_mermaid.rb
-```
-
-The mermaid file generated should look like this:
-
-<img src="02_readme_mermaid.png" width="300px" text-align="left"></img>

data/justfile

@@ -1,70 +0,0 @@
-# Tell 'just' to run bash, source our setup script, then execute the recipe
-set shell := ["bash", "-c"]
-
-version := `grep VERSION lib/inquirex/version.rb | awk '{print $3}' | tr -d '"' | tr -d '\n'`
-rbenv   := 'eval "$(rbenv init bash)"; bundle exec '
-repo    := 'git@github.com:inquirex/inquirex.git'
-
-[no-exit-message]
-recipes:
-    just --choose
-
-# Sync all dependencies
-install:
-    bin/setup
-
-build: install
-
-# Lint and reformat files
-lint:
-    {{ rbenv }} rubocop
-
-# Lint and reformat files (-a) — pass -A as an argument
-format *args:
-    {{ rbenv }} rubocop -a {{ args }}
-
-# Run all the tests
-test *args: 
-    export ENVIRONMENT=test; {{ rbenv }} rspec {{args}}
-
-# Run tests with coverage
-test-coverage *args:
-    export ENVIRONMENT=test; export COVERAGE=true; {{ rbenv }} rspec {{ args }}
-
-ci: lint test-coverage 
-
-alias check-all := ci
-
-clean:
-    #!/usr/bin/env bash
-    @find . -name .DS_Store -delete -print || true
-    @rm -rf tmp/*
-
-# Run all lefthook pre-commit hooks
-lefthook:
-    {{ rbenv }} lefthook run pre-commit --all-files
-
-# Print current gem version
-version:
-    @echo "{{ version }}"
-
-# Clobber
-clobber: 
-    {{ rbenv }} rake clobber
-
-# Generate documentation
-doc: 
-    #!/usr/bin/env bash
-    {{ rbenv }} rake doc
-
-# Create
-publish: build
-    {{ rbenv }} rake release[remote]
-
-# Tag v{{ version }}, publish the GH release, & refresh the Homebrew tap.
-release:
-    git fetch --tags
-    git tag -f "v{{ version }}"
-    git push -f --tags
-    gh release delete -y "v{{ version }}" --repo {{ repo }} 2>/dev/null || true
-    gh release create "v{{ version }}" --generate-notes --repo {{ repo }}

data/lefthook.yml

@@ -1,35 +0,0 @@
-output:
-  - summary
-  - failure
-
-pre-commit:
-  parallel: true
-  jobs:
-    - name: lint
-      run: bundle exec rubocop -c .rubocop.yml {staged_files}
-      glob: "*.{rb,Gemfile}"
-      stage_fixed: true
-
-    - name: check for conflict markers and whitespace issues
-      run: git --no-pager diff --check
-
-    # If tests take >1 second, move this (or just the long-running tests) to pre-push.
-    - name: run tests
-      run: just test
-
-    - name: fix rubocop formatting issues
-      run: bundle exec rubocop -a {staged_files}
-      glob: "*.{rb,Gemfile,gemspec}"
-      stage_fixed: true
-
-    - name: spell check
-      run: codespell {staged_files}
-      glob: "*.{rb,md,gemspec}"
-
-    - name: format markdown
-      run: mdformat {staged_files}
-      glob: "*.md"
-      stage_fixed: true
-
-    - name: scan for secrets
-      run: detect-secrets-hook --baseline .secrets.baseline

data/sig/inquirex.rbs

@@ -1,4 +0,0 @@
-module Inquirex
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end