artificial 0.0.1

data/lib/artificial/validators/message_validator.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Artificial
+  module Validators
+    class MessageValidator
+      VALID_ROLES = %w[system user assistant].freeze
+
+      attr_reader :messages, :errors
+
+      def initialize(messages)
+        @messages = messages
+        @errors = []
+      end
+
+      def validate
+        @errors.clear
+
+        return add_error('Messages must be an array') unless @messages.is_a?(Array)
+        return add_error('Messages array cannot be empty') if @messages.empty?
+
+        @messages.each_with_index do |message, index|
+          validate_message(message, index)
+        end
+
+        self
+      end
+
+      def valid?
+        validate if @errors.empty?
+        @errors.empty?
+      end
+
+      def error_messages
+        @errors
+      end
+
+      private
+
+      def validate_message(message, index)
+        return add_error("Message at index #{index} must be a hash") unless message.is_a?(Hash)
+
+        validate_role(message, index)
+        validate_content(message, index)
+      end
+
+      def validate_role(message, index)
+        role = message[:role] || message['role']
+
+        if role.nil?
+          add_error("Message at index #{index} must have a 'role' key")
+        elsif !VALID_ROLES.include?(role.to_s)
+          add_error("Message at index #{index} has invalid role '#{role}'. Must be one of: #{VALID_ROLES.join(', ')}")
+        end
+      end
+
+      def validate_content(message, index)
+        content = message[:content] || message['content']
+
+        if content.nil?
+          add_error("Message at index #{index} must have a 'content' key")
+        elsif !content.is_a?(String) || content.strip.empty?
+          add_error("Message at index #{index} must have non-empty string content")
+        end
+      end
+
+      def add_error(message)
+        @errors << message
+        false
+      end
+    end
+  end
+end

data/lib/artificial/validators/role_validator.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+module Artificial
+  module Validators
+    class RoleValidator
+      VALID_SYSTEM_ROLES = %w[
+        expert assistant helper instructor teacher guide analyst
+        specialist consultant advisor reviewer critic evaluator
+        researcher scientist engineer developer programmer
+        writer editor translator interpreter
+      ].freeze
+
+      ROLE_PATTERNS = {
+        domain_expert: /^you are (?:a|an) (.+) expert/i,
+        professional: /^you are (?:a|an) (.+) professional/i,
+        specialist: /^you are (?:a|an) (.+) specialist/i,
+        assistant: /^you are (?:a|an) (?:helpful|knowledgeable|.+) assistant/i
+      }.freeze
+
+      attr_reader :system_prompt, :role_type, :errors, :suggestions
+
+      def initialize(system_prompt)
+        @system_prompt = system_prompt
+        @role_type = nil
+        @errors = []
+        @suggestions = []
+      end
+
+      def validate
+        @errors.clear
+        @suggestions.clear
+
+        return add_error('System prompt cannot be empty') if @system_prompt.nil? || @system_prompt.strip.empty?
+
+        analyze_role_effectiveness
+        check_role_clarity
+        provide_optimization_suggestions
+
+        self
+      end
+
+      def valid?
+        validate if @errors.empty?
+        @errors.empty?
+      end
+
+      def effective?
+        validate unless @role_type
+        @role_type != :generic
+      end
+
+      def error_messages
+        @errors
+      end
+
+      def optimization_suggestions
+        @suggestions
+      end
+
+      private
+
+      def analyze_role_effectiveness
+        @role_type = determine_role_type
+
+        case @role_type
+        when :domain_expert
+          add_suggestion('Excellent! Domain expert roles typically improve response quality by 20-30%')
+        when :professional
+          add_suggestion('Good! Professional roles help establish expertise and context')
+        when :specialist
+          add_suggestion('Good! Specialist roles provide focused domain knowledge')
+        when :assistant
+          add_suggestion('Adequate. Consider making the assistant role more specific for better performance')
+        when :generic
+          add_suggestion('Generic roles may reduce AI performance. Consider specifying domain expertise')
+        else
+          add_suggestion('Consider using established role patterns for optimal performance')
+        end
+      end
+
+      def determine_role_type
+        ROLE_PATTERNS.each do |type, pattern|
+          return type if @system_prompt.match?(pattern)
+        end
+
+        return :generic if @system_prompt.downcase.include?('you are')
+
+        :undefined
+      end
+
+      def check_role_clarity
+        unless @system_prompt.downcase.start_with?('you are')
+          add_suggestion("Consider starting with 'You are...' for clearer role definition")
+        end
+
+        if @system_prompt.length < 10
+          add_error('System prompt too short. Add more context about the role and capabilities')
+        elsif @system_prompt.length > 500
+          add_suggestion("Consider shortening system prompt for better focus (current: #{@system_prompt.length} chars)")
+        end
+      end
+
+      def provide_optimization_suggestions
+        if @role_type == :generic || @role_type == :undefined
+          add_suggestion("Try: 'You are a [domain] expert with [X] years of experience in [specialization]'")
+        end
+
+        unless @system_prompt.include?('expert') || @system_prompt.include?('specialist')
+          add_suggestion("Adding 'expert' or 'specialist' can improve response authority")
+        end
+
+        return unless @system_prompt.count('.') < 2
+
+        add_suggestion('Consider adding specific capabilities or constraints to the role')
+      end
+
+      def add_error(message)
+        @errors << message
+        false
+      end
+
+      def add_suggestion(message)
+        @suggestions << message
+        true
+      end
+    end
+  end
+end

data/lib/artificial/version.rb

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

data/lib/artificial.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require_relative 'artificial/version'
+require_relative 'artificial/prompt'
+
+# Load parsers
+require_relative 'artificial/parsers/string_parser'
+require_relative 'artificial/parsers/xml_parser'
+require_relative 'artificial/parsers/yaml_parser'
+require_relative 'artificial/parsers/json_parser'
+
+# Load validators
+require_relative 'artificial/validators/message_validator'
+require_relative 'artificial/validators/role_validator'
+
+module Artificial
+  class Error < StandardError; end
+
+  # Factory method for creating prompts
+  def self.create_prompt(input = nil, **options)
+    Prompt.new(input, **options)
+  end
+
+  # Parse input using appropriate parser
+  def self.parse(input, format: :auto)
+    case format
+    when :auto
+      auto_parse(input)
+    when :string
+      Parsers::StringParser.new(input).parse
+    when :xml
+      Parsers::XMLParser.new(input).parse
+    when :yaml
+      Parsers::YAMLParser.new(input).parse
+    when :json
+      Parsers::JSONParser.new(input).parse
+    else
+      raise ArgumentError, "Unknown format: #{format}"
+    end
+  end
+
+  # Validate messages
+  def self.validate_messages(messages)
+    Validators::MessageValidator.new(messages).validate
+  end
+
+  # Validate role
+  def self.validate_role(system_prompt)
+    Validators::RoleValidator.new(system_prompt).validate
+  end
+
+  def self.auto_parse(input)
+    return Parsers::StringParser.new(input).parse unless input.is_a?(String)
+
+    # Try to detect format from string content
+    input_trimmed = input.strip
+
+    if input_trimmed.start_with?('<') && input_trimmed.end_with?('>')
+      Parsers::XMLParser.new(input).parse
+    elsif input_trimmed.start_with?('{') && input_trimmed.end_with?('}')
+      Parsers::JSONParser.new(input).parse
+    elsif input_trimmed.include?(':') && (input_trimmed.include?('-') || input_trimmed.include?('|') || input_trimmed.include?("\n"))
+      Parsers::YAMLParser.new(input).parse
+    else
+      Parsers::StringParser.new(input).parse
+    end
+  end
+end

data/sig/artificial.rbs

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

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: artificial
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Matt Solt
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: psych
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.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'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: Artificial intelligence library for prompting - not production-ready.
+email:
+- mattsolt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- examples/demo.rb
+- lib/artificial.rb
+- lib/artificial/parsers/json_parser.rb
+- lib/artificial/parsers/string_parser.rb
+- lib/artificial/parsers/xml_parser.rb
+- lib/artificial/parsers/yaml_parser.rb
+- lib/artificial/prompt.rb
+- lib/artificial/validators/message_validator.rb
+- lib/artificial/validators/role_validator.rb
+- lib/artificial/version.rb
+- sig/artificial.rbs
+homepage: https://github.com/roboruby/artificial
+licenses: []
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/roboruby/artificial
+  source_code_uri: https://github.com/roboruby/artificial
+  changelog_uri: https://github.com/roboruby/artificial/blob/main/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/artificial
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Artificial intelligence library for prompting
+test_files: []