ai_guardrails 1.2.0

data/lib/ai_guardrails/safety_filter.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module AiGuardrails
+  # SafetyFilter checks AI outputs for unsafe or unwanted content
+  class SafetyFilter
+    class UnsafeContentError < StandardError; end
+
+    # Initialize with optional list of banned words or regex patterns
+    def initialize(blocklist: [])
+      # convert all items to regex for easier matching
+      @blocklist = blocklist.map do |item|
+        item.is_a?(Regexp) ? item : /\b#{Regexp.escape(item)}\b/i
+      end
+    end
+
+    # Checks the content
+    # Raises UnsafeContentError if any blocked content is detected
+    def check!(content)
+      @blocklist.each do |pattern|
+        raise UnsafeContentError, "Unsafe content detected: #{pattern}" if content.match?(pattern)
+      end
+      true
+    end
+
+    # Returns boolean instead of raising
+    def safe?(content)
+      check!(content)
+      true
+    rescue UnsafeContentError
+      false
+    end
+  end
+end

data/lib/ai_guardrails/schema_validator.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require "dry-validation"
+
+module AiGuardrails
+  # The SchemaValidator builds a runtime validation contract
+  # based on a simple Ruby Hash schema (e.g. { name: :string, tags: [:string] }).
+  # It uses Dry::Validation under the hood and returns a uniform
+  # response format: [success?, result_or_errors].
+  class SchemaValidator
+    attr_reader :contract
+
+    def initialize(schema)
+      @contract = build_contract(schema)
+    end
+
+    # Returns [success?, result_or_errors]
+    def validate(input)
+      result = contract.call(input)
+      if result.success?
+        [true, result.to_h]
+      else
+        [false, result.errors.to_h]
+      end
+    end
+
+    private
+
+    # Dynamically build Dry::Validation contract from simple hash
+    # rubocop:disable Metrics/MethodLength
+    def build_contract(schema_hash)
+      klass = Class.new(Dry::Validation::Contract) do
+        params do
+          schema_hash.each do |key, type|
+            case type
+            when :string
+              required(key).filled(:string)
+            when :integer
+              required(key).filled(:integer)
+            when :float
+              required(key).filled(:float)
+            when :boolean
+              required(key).filled(:bool)
+            when Array
+              # assume array of strings for now
+              required(key).array(:string)
+            else
+              raise ArgumentError, "Unsupported type #{type} for key #{key}"
+            end
+          end
+        end
+      end
+      klass.new
+    end
+    # rubocop:enable Metrics/MethodLength
+  end
+end

data/lib/ai_guardrails/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module AiGuardrails
+  VERSION = "1.2.0"
+end

data/lib/ai_guardrails.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative "ai_guardrails/version"
+require_relative "ai_guardrails/config"
+
+require_relative "ai_guardrails/schema_validator"
+require_relative "ai_guardrails/json_repair"
+require_relative "ai_guardrails/mock_model_client"
+
+require_relative "ai_guardrails/provider/base_client"
+require_relative "ai_guardrails/provider/openai_client"
+require_relative "ai_guardrails/provider/factory"
+
+require_relative "ai_guardrails/auto_correction"
+require_relative "ai_guardrails/safety_filter"
+require_relative "ai_guardrails/logger"
+require_relative "ai_guardrails/runner"
+require_relative "ai_guardrails/dsl"
+require_relative "ai_guardrails/background_job"
+require_relative "ai_guardrails/cli"
+require_relative "ai_guardrails/cache"
+require_relative "ai_guardrails/auto_fix"
+
+# Main namespace for the AiGuardrails gem.
+module AiGuardrails
+  class Error < StandardError; end
+
+  class << self
+    def config
+      @config ||= Config.new
+    end
+
+    def configure
+      yield(config)
+
+      Logger.logger = config.logger
+      Logger.debug_mode = config.debug
+    end
+  end
+end

data/sig/ai_guardrails.rbs

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

metadata

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification
+name: ai_guardrails
+version: !ruby/object:Gem::Version
+  version: 1.2.0
+platform: ruby
+authors:
+- Faisal Raza
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-12-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dry-validation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+description: |
+  AiGuardrails is a Ruby gem that helps developers validate, correct, and enforce schemas
+  on AI-generated outputs. It ensures structured data, prevents JSON errors, and provides
+  a foundation for adding safety filters and auto-correction in Rails apps, CLI tools,
+  background jobs, and scrapers. Think of it as Guardrails.AI for Ruby.
+email:
+- faisalraza.p@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/ai_guardrails.rb
+- lib/ai_guardrails/auto_correction.rb
+- lib/ai_guardrails/auto_fix.rb
+- lib/ai_guardrails/background_job.rb
+- lib/ai_guardrails/cache.rb
+- lib/ai_guardrails/cli.rb
+- lib/ai_guardrails/config.rb
+- lib/ai_guardrails/dsl.rb
+- lib/ai_guardrails/json_repair.rb
+- lib/ai_guardrails/logger.rb
+- lib/ai_guardrails/mock_model_client.rb
+- lib/ai_guardrails/provider/base_client.rb
+- lib/ai_guardrails/provider/factory.rb
+- lib/ai_guardrails/provider/openai_client.rb
+- lib/ai_guardrails/runner.rb
+- lib/ai_guardrails/safety_filter.rb
+- lib/ai_guardrails/schema_validator.rb
+- lib/ai_guardrails/version.rb
+- sig/ai_guardrails.rbs
+homepage: https://github.com/logicbunchhq/ai_guardrails
+licenses:
+- MIT
+metadata:
+  organization: LogicBunch
+  homepage_uri: https://github.com/logicbunchhq/ai_guardrails
+  source_code_uri: https://github.com/logicbunchhq/ai_guardrails
+  changelog_uri: https://github.com/logicbunchhq/ai_guardrails/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/logicbunchhq/ai_guardrails#readme
+  rubygems_keywords: AI, Guardrails, Ruby, LLM, JSON, Schema, Auto-correction, Safety
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: 'AiGuardrails: Schema validation and safety layer for AI-generated output
+  in Ruby'
+test_files: []