prescient 0.0.0 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e070d323c97eb52326235a46037b1168cd4dfb5248628e6b6b4111ec3a688d3f
-  data.tar.gz: 603443ccd445a660674414f05521621c7a1502e325d6f18c26036f52e95fca6c
+  metadata.gz: 62c70c521da514a785f44beb284287d56a3affd451160bcc8bcad26fff713303
+  data.tar.gz: 4b7a41690ae8395cb57ccefee607764d850256d6fe9c4341db038e28ee67c7ce
 SHA512:
-  metadata.gz: afdbe4946f4578443c98dd828637d57dfd54034154a836b1325c35cd6ba20c8d676cb0da48ac3460417d1af0e3ca20c9263c82d868e5142df49c57bd94595183
-  data.tar.gz: 49d8cce788ff8ba94ce4a2a1a18863a93ca79cd7bb17a04e19768e035716429eed2ae38e852dd373471e8f0c20ddb249d6de419f7b53248aaa30da91ec81ecbb
+  metadata.gz: 5cff60610144acef5b2be9693dbe87f1bb7b231dae219ac5cc826c2720fb383ed7c6df580cfe9a9ac26eb56812bc841178d605272adde63054506006cfdd9575
+  data.tar.gz: c6f3eef2edcd1f53eb0c41a779db4b4aae36990e40b91ff406077353fd8c9d3b10332c2c5701a17ba88c3fb2debec6eb4e8560eb14a9c483e387dc146d5f6b18

data/.env.example

@@ -0,0 +1,37 @@
+# Example environment configuration for Prescient gem
+# Copy this file to .env and configure your API keys
+
+# Ollama Configuration (Local AI)
+OLLAMA_URL=http://localhost:11434
+OLLAMA_EMBEDDING_MODEL=nomic-embed-text
+OLLAMA_CHAT_MODEL=llama3.1:8b
+
+# OpenAI Configuration
+OPENAI_API_KEY=your_openai_api_key_here
+OPENAI_EMBEDDING_MODEL=text-embedding-3-small
+OPENAI_CHAT_MODEL=gpt-3.5-turbo
+
+# Anthropic Configuration
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+ANTHROPIC_MODEL=claude-3-haiku-20240307
+
+# HuggingFace Configuration
+HUGGINGFACE_API_KEY=your_huggingface_api_key_here
+HUGGINGFACE_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2
+HUGGINGFACE_CHAT_MODEL=microsoft/DialoGPT-medium
+
+# PostgreSQL with pgvector Configuration
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=prescient_development
+DB_USER=prescient
+DB_PASSWORD=prescient_password
+
+# Optional: Redis for caching (if using with Docker)
+REDIS_URL=redis://localhost:6379/0
+
+# Application Configuration
+PRESCIENT_DEFAULT_PROVIDER=ollama
+PRESCIENT_TIMEOUT=60
+PRESCIENT_RETRY_ATTEMPTS=3
+PRESCIENT_RETRY_DELAY=1.0

data/.rubocop.yml

@@ -0,0 +1,326 @@
+# frozen_string_literal: true
+
+# RuboCop configuration for Prescient gem
+# Modern Ruby best practices with sensible defaults
+
+plugins:
+  - rubocop-minitest
+  - rubocop-performance
+  - rubocop-rake
+
+AllCops:
+  # Target Ruby 3.0+ (matches gemspec requirement)
+  TargetRubyVersion: 3.0
+
+  # Use new cops by default
+  NewCops: enable
+
+  # Exclude common directories
+  Exclude:
+    - 'vendor/**/*'
+    - 'bin/*'
+    - 'tmp/**/*'
+    - 'coverage/**/*'
+    - 'pkg/**/*'
+    - '*.gemspec'
+    - 'Gemfile'
+    - 'Rakefile'
+    - 'examples/**/*'
+
+# === LAYOUT & FORMATTING ===
+
+Layout/LineLength:
+  Max: 120
+  Exclude:
+    - 'test/**/*'
+    - 'lib/prescient.rb'  # Configuration can have long lines
+  AllowedPatterns:
+    - '^\s*#'  # Comments
+    - '^\s*it\s'  # Test descriptions
+    - '^\s*context\s'  # Test contexts
+    - '^\s*describe\s'  # Test descriptions
+
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+Layout/FirstHashElementIndentation:
+  EnforcedStyle: consistent
+
+Layout/FirstArrayElementIndentation:
+  EnforcedStyle: consistent
+
+Layout/HashAlignment:
+  EnforcedHashRocketStyle: table
+  EnforcedColonStyle: table
+
+Layout/SpaceInsideHashLiteralBraces:
+  EnforcedStyle: space
+
+Layout/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+Layout/EmptyLinesAroundClassBody:
+  Enabled: false
+
+# === STYLE ===
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: single_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+  Exclude:
+    - 'examples/**/*'
+
+Style/Documentation:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  EnforcedStyle: compact
+
+Style/TrailingCommaInArguments:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInArrayLiteral:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInHashLiteral:
+  EnforcedStyleForMultiline: comma
+
+Style/HashSyntax:
+  EnforcedStyle: ruby19_no_mixed_keys
+
+Style/Lambda:
+  EnforcedStyle: literal
+
+Style/NumericLiterals:
+  MinDigits: 6
+
+Style/BlockDelimiters:
+  EnforcedStyle: semantic
+  AllowedMethods:
+    - expect
+    - let
+    - subject
+
+Style/WordArray:
+  EnforcedStyle: brackets
+
+Style/SymbolArray:
+  EnforcedStyle: brackets
+
+Style/FormatString:
+  EnforcedStyle: percent
+
+Style/CollectionMethods:
+  PreferredMethods:
+    collect: map
+    collect!: map!
+    detect: find
+    find_all: select
+    reduce: inject
+
+Style/Alias:
+  EnforcedStyle: prefer_alias_method
+
+Style/AccessorGrouping:
+  EnforcedStyle: separated
+
+Style/BisectedAttrAccessor:
+  Enabled: true
+
+Style/RedundantAssignment:
+  Enabled: true
+
+Style/RedundantFetchBlock:
+  Enabled: true
+
+Style/RedundantFileExtensionInRequire:
+  Enabled: true
+
+Style/RedundantRegexpCharacterClass:
+  Enabled: true
+
+Style/RedundantRegexpEscape:
+  Enabled: true
+
+Style/SlicingWithRange:
+  Enabled: true
+
+Style/ExponentialNotation:
+  Enabled: true
+
+Style/HashTransformKeys:
+  Enabled: true
+
+Style/HashTransformValues:
+  Enabled: true
+
+Style/RedundantReturn:
+  AllowMultipleReturnValues: true
+
+# === METRICS ===
+
+Metrics/ModuleLength:
+  Max: 150
+
+Metrics/ClassLength:
+  Max: 150
+  Exclude:
+    - 'test/**/*'
+
+Metrics/MethodLength:
+  Max: 25
+  Exclude:
+    - 'test/**/*'
+    - 'db/**/*'
+    - 'lib/prescient/provider/*.rb'
+
+Metrics/BlockLength:
+  Max: 25
+  Exclude:
+    - 'test/**/*'
+    - 'lib/prescient.rb'  # Configuration block
+
+Metrics/AbcSize:
+  Max: 20
+  Exclude:
+    - 'test/**/*'
+    - 'db/**/*'
+    - 'lib/prescient/provider/*.rb'
+
+Metrics/CyclomaticComplexity:
+  Max: 8
+  Exclude:
+    - 'lib/prescient/provider/*.rb'
+
+Metrics/PerceivedComplexity:
+  Max: 8
+  Exclude:
+    - 'lib/prescient/provider/*.rb'
+
+Metrics/ParameterLists:
+  Max: 5
+  CountKeywordArgs: false
+
+# === LINT ===
+
+Lint/RaiseException:
+  Enabled: true
+
+Lint/StructNewOverride:
+  Enabled: true
+
+Lint/DeprecatedOpenSSLConstant:
+  Enabled: true
+
+Lint/MixedRegexpCaptureTypes:
+  Enabled: true
+
+Lint/DuplicateElsifCondition:
+  Enabled: true
+
+Lint/BinaryOperatorWithIdenticalOperands:
+  Enabled: true
+
+Lint/DuplicateRescueException:
+  Enabled: true
+
+Lint/EmptyConditionalBody:
+  Enabled: true
+
+Lint/FloatComparison:
+  Enabled: true
+
+Lint/MissingSuper:
+  Enabled: true
+
+Lint/OutOfRangeRegexpRef:
+  Enabled: true
+
+Lint/SelfAssignment:
+  Enabled: true
+
+Lint/TopLevelReturnWithArgument:
+  Enabled: true
+
+Lint/UnreachableLoop:
+  Enabled: true
+
+# === NAMING ===
+
+Naming/PredicatePrefix:
+  ForbiddenPrefixes:
+    - is_
+  AllowedMethods:
+    - is_a?
+
+Naming/MemoizedInstanceVariableName:
+  EnforcedStyleForLeadingUnderscores: required
+
+Naming/VariableNumber:
+  EnforcedStyle: snake_case
+
+# === SECURITY ===
+
+Security/Open:
+  Enabled: true
+
+Security/YAMLLoad:
+  Enabled: true
+
+Security/JSONLoad:
+  Enabled: true
+
+# === PERFORMANCE ===
+
+Performance/AncestorsInclude:
+  Enabled: true
+
+Performance/BigDecimalWithNumericArgument:
+  Enabled: true
+
+Performance/RedundantSortBlock:
+  Enabled: true
+
+Performance/RedundantStringChars:
+  Enabled: true
+
+Performance/ReverseFirst:
+  Enabled: true
+
+Performance/SortReverse:
+  Enabled: true
+
+Performance/Squeeze:
+  Enabled: true
+
+Performance/StringInclude:
+  Enabled: true
+
+Performance/Sum:
+  Enabled: true
+
+# === MINITEST ===
+
+Minitest/MultipleAssertions:
+  Max: 10
+
+Minitest/AssertTruthy:
+  Enabled: true
+
+Minitest/AssertWithExpectedArgument:
+  Enabled: true
+
+Minitest/RefuteFalse:
+  Enabled: true
+
+Minitest/RefuteNil:
+  Enabled: true
+
+Minitest/TestMethodName:
+  Enabled: true

data/Dockerfile.example

@@ -0,0 +1,41 @@
+# Example Dockerfile for running Prescient gem applications
+FROM ruby:3.4-alpine
+
+# Install system dependencies
+RUN apk add --no-cache \
+    build-base \
+    curl \
+    git \
+    postgresql-dev \
+    tzdata
+
+# Set working directory
+WORKDIR /app
+
+# Create non-root user
+RUN addgroup -g 1000 -S appuser && \
+    adduser -u 1000 -S appuser -G appuser
+
+# Copy Gemfile and Gemfile.lock
+COPY Gemfile* ./
+COPY prescient.gemspec ./
+COPY lib/prescient/version.rb ./lib/prescient/
+
+# Install gems
+RUN bundle config --global frozen 1 && \
+    bundle install --jobs 4 --retry 3
+
+# Copy application code
+COPY . .
+
+# Change ownership to appuser
+RUN chown -R appuser:appuser /app
+
+# Switch to non-root user
+USER appuser
+
+# Expose port (if running a web service)
+EXPOSE 3000
+
+# Default command
+CMD ["bundle", "exec", "ruby", "examples/custom_contexts.rb"]