assistant 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09debc25925efe528550417aa223884831986d10b2cc03cf4ee90d482c8966d8'
-  data.tar.gz: 7a85f7175157ed02e36b553b6319ea60b8c8561059acaa4e95d6b6b3f64b368b
+  metadata.gz: a5c9349088dd10a8a058d3d95c0fb80217f5ac5abd2a7bded0e2d19018baf1fb
+  data.tar.gz: e8494d003e8a5cfe35da752c9234f6635db669f0529a941bef551ae143096c79
 SHA512:
-  metadata.gz: 7cc5a1dc3e39ccc9db173421f21b8d39dae763b02c5f14fe21e9827cefefca58ffb86f5f6553a581d0226e46a22069de81ab7a74fd192106a38a669558867a8b
-  data.tar.gz: cf7eee57978f89ade9005c6b021b691a2a35d26de50ec1e601e57b9069db6449eb398c4f8064f757237844e4e0162df20a03b1985f63e5986155d71326aa725a
+  metadata.gz: d336fd45017b3d6446bb1dd5d4f697ad3ee962295761201521dc15a8b423da336d1d9ab0eecd0d04c0486db9c2886c3e5c49cd845581bad67f1bee8131758a20
+  data.tar.gz: 68153612bb94532f476072fc7b326eeb392248cd6161fccdcf654315c36b437e4f1c4e90f78d3d13fb15da3e87ecae2182161e94f263f820d30a0c7cb4599a20

data/.editorconfig

@@ -0,0 +1,13 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+quote_type = single

data/.github/dependabot.yml

@@ -0,0 +1,15 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "bundler" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

data/.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+---
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+# Default to least privilege; jobs may opt into more.
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Minitest (Ruby ${{ matrix.ruby }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['3.4', '4.0']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run tests
+        run: bundle exec rake test
+
+  rubocop:
+    name: RuboCop
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '4.0'
+          bundler-cache: true
+      - name: Run RuboCop
+        run: bundle exec rubocop --parallel

data/.github/workflows/release.yml

@@ -0,0 +1,46 @@
+---
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+
+# Default to least privilege; the release job opts into the perms it needs.
+permissions:
+  contents: read
+
+jobs:
+  release:
+    name: Build and publish gem
+    runs-on: ubuntu-latest
+    environment: rubygems
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '4.0'
+          bundler-cache: true
+
+      - name: Run tests before publishing
+        run: bundle exec rake test
+
+      - name: Configure trusted publishing
+        uses: rubygems/configure-rubygems-credentials@v1.0.0
+
+      - name: Build gem
+        run: gem build assistant.gemspec
+
+      - name: Push gem to RubyGems
+        run: gem push assistant-*.gem
+
+      - name: Create GitHub Release
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: assistant-*.gem

data/.gitignore

@@ -9,3 +9,5 @@
 
 # rspec failure tracking
 .rspec_status
+.byebug_history
+assistant-*.gem

data/.markdownlint.json

@@ -0,0 +1,6 @@
+{
+  "default": true,
+  "MD013": false,
+  "MD024": { "siblings_only": true },
+  "MD043": false
+}

data/.rubocop.yml

@@ -1,44 +1,39 @@
-# This is the configuration used to check the rubocop source code.
-require:
-  - rubocop/cop/internal_affairs
+inherit_from: .rubocop_todo.yml
+
+plugins:
   - rubocop-performance
-  - rubocop-rspec
-  - rubocop-faker
+  - rubocop-minitest
+
+require:
+  - rubocop-rake
 
 AllCops:
   NewCops: enable
+  TargetRubyVersion: 3.4
+  SuggestExtensions: false
   Exclude:
     - 'vendor/**/*'
-    - 'spec/fixtures/**/*'
     - 'tmp/**/*'
     - '.git/**/*'
     - 'bin/*'
-  TargetRubyVersion: 2.5
-  SuggestExtensions: false
+    - 'Gemfile.lock'
+
+Gemspec/DevelopmentDependencies:
+  EnforcedStyle: gemspec
+
+Gemspec/DependencyVersion:
+  Enabled: true
 
-Naming/PredicateName:
-  # Method define macros for dynamically generated method.
+Naming/PredicatePrefix:
   MethodDefinitionMacros:
     - define_method
     - define_singleton_method
-    - def_node_matcher
-    - def_node_search
 
-Style/AccessorGrouping:
+# Tests use simple `def execute = true` to fabricate services; the boolean
+# return doesn't make these predicate methods.
+Naming/PredicateMethod:
   Exclude:
-    - lib/rubocop/formatter/base_formatter.rb
-    - lib/rubocop/cop/offense.rb
-
-Style/FormatStringToken:
-  # Because we parse a lot of source codes from strings. Percent arrays
-  # look like unannotated format string tokens to this cop.
-  Exclude:
-    - spec/**/*
-
-Style/IpAddresses:
-  # The test for this cop includes strings that would cause offenses
-  Exclude:
-  - spec/rubocop/cop/style/ip_addresses_spec.rb
+    - 'test/**/*.rb'
 
 Layout/EndOfLine:
   EnforcedStyle: lf
@@ -49,13 +44,6 @@ Layout/ClassStructure:
 Layout/RedundantLineBreak:
   Enabled: true
 
-Layout/TrailingWhitespace:
-  AllowInHeredoc: false
-
-Lint/AmbiguousBlockAssociation:
-  Exclude:
-    - 'spec/**/*.rb'
-
 Layout/HashAlignment:
   EnforcedHashRocketStyle:
     - key
@@ -66,83 +54,32 @@ Layout/HashAlignment:
 
 Layout/LineLength:
   Max: 120
-  IgnoredPatterns:
-    - !ruby/regexp /\A +(it|describe|context|shared_examples|include_examples|it_behaves_like) ["']/
-
-Lint/InterpolationCheck:
-  Exclude:
-    - 'spec/**/*.rb'
 
-Lint/UselessAccessModifier:
-  MethodCreatingMethods:
-    - 'def_matcher'
-    - 'def_node_matcher'
+Style/RequireOrder:
+  Enabled: true
 
+# Test files use anonymous Class.new(...) blocks and dynamic define_method,
+# which inflates length/metrics counts that don't reflect real complexity.
 Metrics/BlockLength:
   Exclude:
     - 'Rakefile'
     - '**/*.rake'
-    - 'spec/**/*.rb'
+    - 'test/**/*.rb'
     - '**/*.gemspec'
 
 Metrics/ClassLength:
   Exclude:
-    - lib/rubocop/config_obsoletion.rb
-
-Metrics/ModuleLength:
-  Exclude:
-    - 'spec/**/*.rb'
-
-Naming/InclusiveLanguage:
-  FlaggedTerms:
-    offence:
-      Suggestions:
-        - offense
-  Exclude:
-    - lib/rubocop/cop/naming/inclusive_language.rb
-
-RSpec/FilePath:
-  Exclude:
-    - spec/rubocop/cop/internal_affairs/redundant_let_rubocop_config_new_spec.rb
-    - spec/rubocop/formatter/junit_formatter_spec.rb
-
-RSpec/PredicateMatcher:
-  EnforcedStyle: explicit
-
-RSpec/MessageSpies:
-  EnforcedStyle: receive
+    - 'test/**/*.rb'
 
-RSpec/NestedGroups:
-  Max: 7
-
-RSpec/MultipleMemoizedHelpers:
-  Enabled: false
-
-Performance/CollectionLiteralInLoop:
+Metrics/MethodLength:
   Exclude:
-    - 'Rakefile'
-    - 'spec/**/*.rb'
-
-Performance/EndWith:
-  SafeMultiline: false
-
-Performance/StartWith:
-  SafeMultiline: false
+    - 'test/**/*.rb'
 
-RSpec/StubbedMock:
-  Enabled: false
+Naming/MethodParameterName:
+  AllowedNames:
+    - a
+    - b
+    - c
 
-InternalAffairs/ExampleDescription:
-  Include:
-    - 'spec/rubocop/cop/**/*.rb'
-
-InternalAffairs/UndefinedConfig:
-  Include:
-    - 'lib/rubocop/cop/**/*.rb'
-  Exclude:
-    - 'lib/rubocop/cop/correctors/**/*.rb'
-    - 'lib/rubocop/cop/mixin/**/*.rb'
-
-InternalAffairs/StyleDetectedApiUse:
-  Exclude:
-    - 'lib/rubocop/cop/mixin/percent_array.rb'
+Minitest/MultipleAssertions:
+  Max: 8

data/.rubocop_todo.yml

@@ -0,0 +1,7 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config --auto-gen-only-exclude --exclude-limit 20000`
+# on 2023-11-27 19:58:04 UTC using RuboCop version 1.57.2.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.

data/.ruby-version

@@ -1 +1 @@
-2.5.8
+3.4.1

data/CHANGELOG.md

@@ -0,0 +1,56 @@
+<!-- markdownlint-disable MD043 -->
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-05-07
+
+### Added
+
+- `LogList#log_item_error_initialize` helper, used by `InputBuilder`-generated
+  validators (previously redefined on every `input` declaration).
+- GitHub Actions CI workflow (`.github/workflows/ci.yml`) running Minitest and
+  RuboCop.
+- GitHub Actions release workflow (`.github/workflows/release.yml`) using
+  RubyGems trusted publishing (OIDC) on `v*.*.*` tags.
+- Direct test coverage for `LogList#warnings`, `#errors`, `#merge_logs`,
+  `Service#success?`, `#failure?`, `#status`, `#result` memoization,
+  conditional requirement behavior, the `inputs(...)` plural DSL form, and
+  `LogItem#trace`/`#item`.
+
+### Changed
+
+- Standardized on Ruby 3.4 (`.ruby-version`, gemspec `required_ruby_version`,
+  RuboCop `TargetRubyVersion`).
+- `InputBuilder` no longer requires `active_support`; the previous use of
+  `Object#present?` is replaced with plain Ruby checks. Whitespace-only
+  strings continue to be treated as missing via a scoped
+  `Assistant::Refinements::StringBlankness` refinement that adds
+  `String#whitespace?` and is activated inside `InputBuilder`. The method is
+  intentionally named to avoid colliding with ActiveSupport's `String#blank?`.
+- `assistant.gemspec` `changelog_uri` now points at `CHANGELOG.md` instead of
+  `CODE_OF_CONDUCT.md`.
+- Migrated the test suite from RSpec to Minitest (`test/**/*_test.rb`),
+  exposed via `rake test` (the new default rake task).
+- Replaced the largely-dead RuboCop config (a fork of RuboCop's own internal
+  config) with a focused configuration for this gem; `rubocop-rspec` is
+  replaced with `rubocop-minitest`.
+
+### Removed
+
+- CircleCI configuration (`.circleci/`); replaced by GitHub Actions.
+- Dead `@keys = []` instance variable in `Assistant::Service#initialize`.
+- `active_support` and `active_support/core_ext/object` requires from
+  `lib/assistant/input_builder.rb`.
+- RSpec, FactoryBot, Faker, `rspec-collection_matchers`,
+  `rspec_junit_formatter`, `rubocop-faker`, and `rubocop-rspec` development
+  dependencies; replaced by `minitest` and `rubocop-minitest`.
+
+## [0.0.2] - 2023-11-27
+
+- Initial public release.

data/Gemfile.lock

@@ -1,83 +1,118 @@
 PATH
   remote: .
   specs:
-    assistant (0.0.0)
+    assistant (0.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.2)
-    brakeman (5.2.0)
-    colorize (0.8.1)
-    concurrent-ruby (1.1.9)
-    diff-lcs (1.5.0)
-    faker (2.19.0)
-      i18n (>= 1.6, < 2)
-    fasterer (0.9.0)
-      colorize (~> 0.7)
-      ruby_parser (>= 3.14.1)
-    i18n (1.8.11)
-      concurrent-ruby (~> 1.0)
-    parallel (1.21.0)
-    parser (3.1.0.0)
+    ast (2.4.3)
+    brakeman (8.0.4)
+      racc
+    byebug (13.0.0)
+      reline (>= 0.6.0)
+    colorize (1.1.0)
+    fasterer (0.11.0)
+      ruby_parser (>= 3.19.1)
+    io-console (0.8.2)
+    json (2.19.5)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    minitest (5.27.0)
+    parallel (2.1.0)
+    parser (3.3.11.1)
       ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.2.0)
-    rexml (3.2.5)
-    rspec (3.10.0)
-      rspec-core (~> 3.10.0)
-      rspec-expectations (~> 3.10.0)
-      rspec-mocks (~> 3.10.0)
-    rspec-core (3.10.1)
-      rspec-support (~> 3.10.0)
-    rspec-expectations (3.10.2)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-mocks (3.10.2)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-support (3.10.3)
-    rubocop (1.25.0)
-      parallel (~> 1.10)
-      parser (>= 3.1.0.0)
+    rake (13.4.2)
+    regexp_parser (2.12.0)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rubocop (1.86.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml
-      rubocop-ast (>= 1.15.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.15.1)
-      parser (>= 3.0.1.1)
-    rubocop-faker (1.1.0)
-      faker (>= 2.12.0)
-      rubocop (>= 0.82.0)
-    rubocop-performance (1.13.2)
-      rubocop (>= 1.7.0, < 2.0)
-      rubocop-ast (>= 0.4.0)
-    rubocop-rspec (2.7.0)
-      rubocop (~> 1.19)
-    ruby-progressbar (1.11.0)
-    ruby_parser (3.18.1)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-minitest (0.39.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    ruby-progressbar (1.13.0)
+    ruby_parser (3.22.0)
+      racc (~> 1.5)
       sexp_processor (~> 4.16)
-    sexp_processor (4.16.0)
-    unicode-display_width (2.1.0)
+    sexp_processor (4.17.5)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
 
 PLATFORMS
-  x86_64-darwin-20
+  arm64-darwin-25
+  ruby
 
 DEPENDENCIES
   assistant!
-  brakeman (~> 5.2)
-  bundler (~> 2.3, >= 2.3.5)
-  colorize (~> 0.8.1)
-  fasterer (~> 0.9.0)
-  rake (~> 13.0, >= 13.0.6)
-  rspec (~> 3.10)
-  rubocop (~> 1.24, >= 1.24.1)
-  rubocop-faker (~> 1.1)
-  rubocop-performance (~> 1.13, >= 1.13.2)
-  rubocop-rspec (~> 2.7)
+  brakeman (~> 8.0)
+  bundler (~> 4.0)
+  byebug (~> 13.0)
+  colorize (~> 1.1)
+  fasterer (~> 0.11.0)
+  minitest (~> 5.25)
+  rake (~> 13.4)
+  rubocop (~> 1.86)
+  rubocop-minitest (~> 0.39)
+  rubocop-performance (~> 1.26)
+  rubocop-rake (~> 0.7)
+
+CHECKSUMS
+  assistant (0.1.0)
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  brakeman (8.0.4) sha256=7bf921fa9638544835df9aa7b3e720a9a72c0267f34f92135955edd80d4dcf6f
+  bundler (4.0.11) sha256=5bcec0fb78302e48d02ee46f10ee6e6942be647ba5b44a6d1ddfda9a240ce785
+  byebug (13.0.0) sha256=d2263efe751941ca520fa29744b71972d39cbc41839496706f5d9b22e92ae05d
+  colorize (1.1.0) sha256=30b5237f0603f6662ab8d1fc2bd4a96142b806c6415d79e45ef5fdc6a0cfc837
+  fasterer (0.11.0) sha256=9c38b77583584f3339a729eb077fd8f2856a317abe747528f6563d7c23e9dda8
+  io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
+  json (2.19.5) sha256=218a18553e4801d579ca7e0f5bc72bafd776d7397238a1fb4e74db5b0a812c59
+  language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  minitest (5.27.0) sha256=2d3b17f8a36fe7801c1adcffdbc38233b938eb0b4966e97a6739055a45fa77d5
+  parallel (2.1.0) sha256=b35258865c2e31134c5ecb708beaaf6772adf9d5efae28e93e99260877b09356
+  parser (3.3.11.1) sha256=d17ace7aabe3e72c3cc94043714be27cc6f852f104d81aa284c2281aecc65d54
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
+  regexp_parser (2.12.0) sha256=35a916a1d63190ab5c9009457136ae5f3c0c7512d60291d0d1378ba18ce08ebb
+  reline (0.6.3) sha256=1198b04973565b36ec0f11542ab3f5cfeeec34823f4e54cebde90968092b1835
+  rubocop (1.86.1) sha256=44415f3f01d01a21e01132248d2fd0867572475b566ca188a0a42133a08d4531
+  rubocop-ast (1.49.1) sha256=4412f3ee70f6fe4546cc489548e0f6fcf76cafcfa80fa03af67098ffed755035
+  rubocop-minitest (0.39.1) sha256=998398d6da4026d297f0f9bf709a1eac5f2b6947c24431f94af08138510cf7ed
+  rubocop-performance (1.26.1) sha256=cd19b936ff196df85829d264b522fd4f98b6c89ad271fa52744a8c11b8f71834
+  rubocop-rake (0.7.1) sha256=3797f2b6810c3e9df7376c26d5f44f3475eda59eb1adc38e6f62ecf027cbae4d
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  ruby_parser (3.22.0) sha256=1eb4937cd9eb220aa2d194e352a24dba90aef00751e24c8dfffdb14000f15d23
+  sexp_processor (4.17.5) sha256=ae2b48ba98353d5d465ce8759836b7a05f2e12c5879fcd14d7815b026de32f0e
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
 
 BUNDLED WITH
-   2.3.5
+  4.0.11

data/Rakefile

@@ -1,6 +1,13 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+# frozen_string_literal: true
 
-RSpec::Core::RakeTask.new(:spec)
+require 'bundler/gem_tasks'
+require 'rake/testtask'
 
-task :default => :spec
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+  t.warning = false
+end
+
+task default: :test

data/assistant.gemspec

@@ -6,45 +6,42 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'assistant/version'
 
 Gem::Specification.new do |spec|
+  raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.' unless spec.respond_to?(:metadata)
+
   spec.name = 'assistant'
   spec.version = Assistant::VERSION
   spec.authors = ['Ramon Rodrigues']
   spec.email = ['cerberus.ramon@gmail.com']
 
-  spec.summary = 'Simple, composable services'
+  spec.summary = 'Simple, soft fail enabled, composable services'
   spec.description = 'Simple, composable services'
   spec.homepage = 'https://github.com/ramongr/assistant'
   spec.license = 'MIT'
-  spec.required_ruby_version = '>= 2.5.8'
-
-  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
-  # to allow pushing to a single host or delete this section to allow pushing to any host.
-  if spec.respond_to?(:metadata)
-    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
-    spec.metadata['changelog_uri'] = 'https://github.com/ramongr/assistant/blob/main/CODE_OF_CONDUCT.md'
-    spec.metadata['homepage_uri'] = spec.homepage
-    spec.metadata['source_code_uri'] = 'https://github.com/ramongr/assistant'
-  else
-    raise 'RubyGems 2.0 or newer is required to protect against ' \
-          'public gem pushes.'
-  end
+  spec.required_ruby_version = '>= 3.4'
+
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  spec.metadata['changelog_uri'] = 'https://github.com/ramongr/assistant/blob/main/CHANGELOG.md'
+  spec.metadata['homepage_uri'] = 'https://github.com/ramongr/assistant'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+  spec.metadata['source_code_uri'] = 'https://github.com/ramongr/assistant'
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.bindir = 'exe'
-  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ['lib']
-  spec.add_development_dependency 'brakeman', '~> 5.2'
-  spec.add_development_dependency 'colorize', '~> 0.8.1'
-  spec.add_development_dependency 'bundler', '~> 2.3', '>= 2.3.5'
-  spec.add_development_dependency 'fasterer', '~> 0.9.0'
-  spec.add_development_dependency 'rake', '~> 13.0', '>= 13.0.6'
-  spec.add_development_dependency 'rspec', '~> 3.10'
-  spec.add_development_dependency 'rubocop', '~> 1.24', '>= 1.24.1'
-  spec.add_development_dependency 'rubocop-faker', '~> 1.1'
-  spec.add_development_dependency 'rubocop-performance', '~> 1.13', '>= 1.13.2'
-  spec.add_development_dependency 'rubocop-rspec', '~> 2.7'
+
+  spec.require_paths = 'lib'
+
+  spec.add_development_dependency 'brakeman', '~> 8.0'
+  spec.add_development_dependency 'bundler', '~> 4.0'
+  spec.add_development_dependency 'byebug', '~> 13.0'
+  spec.add_development_dependency 'colorize', '~> 1.1'
+  spec.add_development_dependency 'fasterer', '~> 0.11.0'
+  spec.add_development_dependency 'minitest', '~> 5.25'
+  spec.add_development_dependency 'rake', '~> 13.4'
+  spec.add_development_dependency 'rubocop', '~> 1.86'
+  spec.add_development_dependency 'rubocop-minitest', '~> 0.39'
+  spec.add_development_dependency 'rubocop-performance', '~> 1.26'
+  spec.add_development_dependency 'rubocop-rake', '~> 0.7'
 end

data/bin/console

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
-require "bundler/setup"
-require "assistant"
+require 'bundler/setup'
+require 'assistant'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
@@ -10,5 +10,5 @@ require "assistant"
 # require "pry"
 # Pry.start
 
-require "irb"
+require 'irb'
 IRB.start(__FILE__)

data/bin/version

@@ -8,16 +8,12 @@ def process_command(argument)
   original_version = version_arr.join('.')
   case argument
   when '-h', '--help'
-    puts '                                 VERSION BUMP OPTIONS                                '
-    puts '--bump-patch-version --patch                                  Bumps the patch version'
-    puts '--bump-minor-version --minor  Bumps the minor version and sets the patch version to 0'
-    puts '--bump-major-version --version     Bumps the major version sets all other values to 0'
-    return
-  when '--bump-patch-version', '--patch'
+    return puts help_message
+  when '--patch-version', '--patch'
     bumped_version = [version_arr[0], version_arr[1], version_arr[2] + 1].join('.')
-  when '--bump-minor-version', '--minor'
+  when '--minor-version', '--minor'
     bumped_version = [version_arr[0], version_arr[1] + 1, 0].join('.')
-  when '--bump-major-version', '--version'
+  when '--major-version', '--version'
     bumped_version = [version_arr[0] + 1, 0, 0].join('.')
   else
     return puts "Invalid command #{argument}, use --help to see all available commands".colorize(:red)
@@ -27,6 +23,15 @@ def process_command(argument)
   write_file(bumped_version_file)
 end
 
+private
+
+def help_message
+  puts "\t\t\t\t\tVERSION BUMP OPTIONS\t\t\t\t\t"
+  puts "--patch-version --patch\t\tBumps the patch version\t\t\t\t\t"
+  puts "--minor-version --minor\t\tBumps the minor version and sets the patch version to 0 "
+  puts "--major-version --version\t\tBumps the major version sets all other values to 0\t"
+end
+
 def write_file(text)
   File.write(VERSION_FILE, text)
 end
@@ -45,4 +50,4 @@ end
 
 ARGV.each do |argument|
   process_command(argument)
-end
+end

data/lib/assistant/input_builder.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require 'assistant/refinements/string_blankness'
+
+module Assistant
+  # This module has the building blocks for the input validation.
+  # The building blocks of listing inputs with the #input and #inputs methods
+  # and the building blocks of validating inputs with the methods that are called within those methods.
+  module InputBuilder
+    using Assistant::Refinements::StringBlankness
+
+    # Lists all inputs that have the same type and options.
+    def inputs(attr_names, type:, **)
+      attr_names.each do |attr_name|
+        input(attr_name, type:, **)
+      end
+    end
+
+    # Individual input with a specific type or options
+    def input(attr_name, type:, **options)
+      # Base Methods
+      input_getter_meth(attr_name)
+      input_checker_meth(attr_name)
+
+      # Input type validation method, simple and conditional requirement validation methods
+      input_type_validator_meth(attr_name, type)
+      input_require_validator_meth(attr_name, **options) if options[:required] == true
+      input_require_conditional_meth(attr_name, **options) if options[:required] == true && options[:if]
+    end
+
+    def input_getter_meth(attr_name)
+      define_method(attr_name) do
+        @inputs[attr_name]
+      end
+    end
+
+    def input_checker_meth(attr_name)
+      define_method("#{attr_name}?") do
+        val = @inputs[attr_name]
+        return false if val.nil? || val == false
+        return !val.whitespace? if val.is_a?(String)
+
+        val.respond_to?(:empty?) ? !val.empty? : true
+      end
+    end
+
+    def input_require_validator_meth(attr_name, **options)
+      define_method("valid_require_#{attr_name}?") do |log = true|
+        return true if options[:required] == true && send("#{attr_name}?") == true
+
+        log && send(
+          :log_item_error_initialize, attr_name:, message: "Service is missing argument with name #{attr_name}"
+        )
+        false
+      end
+    end
+
+    def input_require_conditional_meth(attr_name, **options)
+      define_method("valid_require_conditional_#{attr_name}?") do
+        return false if send("valid_require_#{attr_name}?", false) == false
+        return true if options[:if].call(send(attr_name))
+
+        send(
+          :log_item_error_initialize,
+          attr_name:, message: "Service argument conditional requirement not met properly for #{attr_name}"
+        )
+        false
+      end
+    end
+
+    def input_type_validator_meth(attr_name, type)
+      define_method("valid_type_#{attr_name}?") do
+        return true if @inputs[attr_name].is_a?(type)
+
+        send("#{attr_name}?") &&
+          send(
+            :log_item_error_initialize,
+            attr_name:, message: "Service argument with name #{attr_name} is not a #{type} but #{send(attr_name).class}"
+          )
+        false
+      end
+    end
+  end
+end

data/lib/assistant/log_item.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Assistant
+  # Log base class
+  class LogItem
+    VALID_LEVELS = %i[info warning error].freeze
+
+    attr_reader :level, :source, :detail, :message, :trace
+
+    def initialize(level:, source:, detail:, message:, trace: nil)
+      @level = level.to_sym
+      @source = source.to_sym
+      @detail = detail.to_sym
+      @message = message.to_s
+      @trace = trace
+    end
+
+    def valid?
+      [valid_level?, valid_source?, valid_detail?, valid_message?].all?
+    end
+
+    def item
+      { level:, source:, detail:, message:, trace: }
+    end
+
+    VALID_LEVELS.each do |valid_level|
+      # info? warning? error?
+      define_method("#{valid_level}?") do
+        level == valid_level
+      end
+    end
+
+    def valid_level?
+      VALID_LEVELS.include?(level)
+    end
+
+    def valid_source?
+      source.size.positive? && detail != source
+    end
+
+    def valid_detail?
+      detail.size.positive? && source != detail
+    end
+
+    def valid_message?
+      message.size.positive?
+    end
+  end
+end

data/lib/assistant/log_list.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Assistant
+  # Service level list of logs
+  module LogList
+    def add_log(level:, source:, detail:, message:, trace: nil)
+      @logs << Assistant::LogItem.new(level:, source:, detail:, message:, trace:)
+    end
+
+    def merge_logs(other_logs)
+      @logs.concat(other_logs)
+    end
+
+    # Convenience used by InputBuilder-generated validators to record an
+    # initialization-time error for a specific input attribute.
+    def log_item_error_initialize(attr_name:, message:)
+      @logs << Assistant::LogItem.new(detail: attr_name, level: :error, message:, source: :initialize)
+    end
+
+    ::Assistant::LogItem::VALID_LEVELS.each do |level|
+      define_method("#{level}s") do
+        @logs.select { |log| log.send("#{level}?") }
+      end
+    end
+  end
+end

data/lib/assistant/refinements/string_blankness.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Assistant
+  module Refinements
+    # Refines String with `#whitespace?`, true when a string is empty or
+    # contains only whitespace characters. Used by `InputBuilder` validators
+    # to treat whitespace-only strings as missing input without depending on
+    # ActiveSupport's `String#blank?`.
+    module StringBlankness
+      refine String do
+        # True when the string is empty or contains only whitespace.
+        def whitespace?
+          strip.empty?
+        end
+      end
+    end
+  end
+end

data/lib/assistant/service.rb

@@ -1,18 +1,65 @@
 # frozen_string_literal: true
 
+require_relative 'input_builder'
+require_relative 'log_list'
+
 module Assistant
   # Base class for the Assistant gem
   class Service
-    def initialize(*args)
+    include LogList
+
+    class << self
+      include InputBuilder
+
+      def run(**)
+        new(**).run
+      end
+    end
+
+    def initialize(**args)
       @inputs = args
+      @logs = []
     end
 
     def run
-      execute
+      validate_inputs
+      validate
+
+      if errors.empty?
+        { result:, status:, warnings: }
+      else
+        { errors:, result: nil, status: :with_errors }
+      end
+    end
+
+    def result
+      @result ||= execute
+    end
+
+    def success?
+      errors.empty?
+    end
+
+    def failure?
+      errors.any?
+    end
+
+    def status
+      warnings.empty? ? :ok : :with_warnings
     end
 
-    protected
+    private
+
+    def validate_inputs
+      methods.grep(/valid_(require|type|require_conditional)_\w+\?$/).each do |validation_method|
+        send(validation_method)
+      end
+    end
+
+    attr_reader :inputs
 
     def execute; end
+
+    def validate; end
   end
 end

data/lib/assistant/service.rbs

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class Assistant::Service
+
+end

data/lib/assistant/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Assistant
-  VERSION = '0.0.1'
+  VERSION = '0.1.0'
 end

data/lib/assistant.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
-require 'assistant/version'
+require 'assistant/log_item'
 require 'assistant/service'
+require 'assistant/version'
 
+# Main Assistant lib entry point
 module Assistant
 end

data/mise.toml

@@ -0,0 +1,4 @@
+[tools]
+opencode="latest"
+ruby="3.4"
+gh="latest"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: assistant
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Ramon Rodrigues
-autorequire:
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2022-02-05 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: brakeman
@@ -16,164 +15,154 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '8.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '8.0'
 - !ruby/object:Gem::Dependency
-  name: colorize
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: '4.0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: byebug
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.3.5
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
-    - - ">="
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.5
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: fasterer
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: 0.11.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.0
+        version: 0.11.0
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 13.0.6
+        version: '5.25'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 13.0.6
+        version: '5.25'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: '13.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: '13.4'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.24'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.24.1
+        version: '1.86'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.24'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.24.1
+        version: '1.86'
 - !ruby/object:Gem::Dependency
-  name: rubocop-faker
+  name: rubocop-minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '0.39'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '0.39'
 - !ruby/object:Gem::Dependency
   name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.13'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.13.2
+        version: '1.26'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.13'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.13.2
+        version: '1.26'
 - !ruby/object:Gem::Dependency
-  name: rubocop-rspec
+  name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '0.7'
 description: Simple, composable services
 email:
 - cerberus.ramon@gmail.com
@@ -181,11 +170,17 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".editorconfig"
 - ".fasterer.yml"
+- ".github/dependabot.yml"
+- ".github/workflows/ci.yml"
+- ".github/workflows/release.yml"
 - ".gitignore"
-- ".rspec"
+- ".markdownlint.json"
 - ".rubocop.yml"
+- ".rubocop_todo.yml"
 - ".ruby-version"
+- CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - Gemfile.lock
@@ -197,17 +192,23 @@ files:
 - bin/setup
 - bin/version
 - lib/assistant.rb
+- lib/assistant/input_builder.rb
+- lib/assistant/log_item.rb
+- lib/assistant/log_list.rb
+- lib/assistant/refinements/string_blankness.rb
 - lib/assistant/service.rb
+- lib/assistant/service.rbs
 - lib/assistant/version.rb
+- mise.toml
 homepage: https://github.com/ramongr/assistant
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  changelog_uri: https://github.com/ramongr/assistant/blob/main/CODE_OF_CONDUCT.md
+  changelog_uri: https://github.com/ramongr/assistant/blob/main/CHANGELOG.md
   homepage_uri: https://github.com/ramongr/assistant
+  rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/ramongr/assistant
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -215,15 +216,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.8
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
-signing_key:
+rubygems_version: 4.0.6
 specification_version: 4
-summary: Simple, composable services
+summary: Simple, soft fail enabled, composable services
 test_files: []

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper