promptly 0.1.13 → 0.1.21

data/wiki/Rails-App-Integration.md

@@ -0,0 +1,116 @@
+## Rails App Integration
+
+### Service Object Pattern
+
+```ruby
+# app/services/ai_prompt_service.rb
+class AiPromptService
+  def self.generate_welcome_email(user, locale: I18n.locale)
+    prompt = Promptly.render(
+      "user_onboarding/welcome_email",
+      locale: locale,
+      locals: {
+        name: user.full_name,
+        app_name: Rails.application.class.module_parent_name,
+        user_role: user.role.humanize,
+        features: available_features_for(user),
+        days_since_signup: (Date.current - user.created_at.to_date).to_i
+      }
+    )
+    
+    # Send to AI service and return generated content
+    openai_client.chat(
+      model: "gpt-4",
+      messages: [{role: "user", content: prompt}]
+    ).dig("choices", 0, "message", "content")
+  end
+
+  private
+
+  def self.available_features_for(user)
+    # Return features based on user's plan, role, etc.
+    case user.plan
+    when "basic"
+      ["Create projects", "Basic reporting"]
+    when "pro"
+      ["Create projects", "Team collaboration", "Advanced analytics", "API access"]
+    else
+      ["Create projects"]
+    end
+  end
+
+  def self.openai_client
+    @openai_client ||= OpenAI::Client.new(access_token: Rails.application.credentials.openai_api_key)
+  end
+end
+```
+
+### Mailer Integration
+
+```ruby
+# app/mailers/user_mailer.rb
+class UserMailer < ApplicationMailer
+  def welcome_email(user)
+    @user = user
+    @ai_content = AiPromptService.generate_welcome_email(user, locale: user.locale)
+    
+    mail(
+      to: user.email,
+      subject: t('mailer.welcome.subject')
+    )
+  end
+end
+```
+
+### Background Job Usage
+
+```ruby
+# app/jobs/generate_ai_content_job.rb
+class GenerateAiContentJob < ApplicationJob
+  def perform(user_id, prompt_identifier, locals = {})
+    user = User.find(user_id)
+    
+    prompt = Promptly.render(
+      prompt_identifier,
+      locale: user.locale,
+      locals: locals.merge(
+        user_name: user.full_name,
+        user_role: user.role,
+        account_type: user.account_type
+      )
+    )
+    
+    # Generate AI content
+    ai_response = openai_client.chat(
+      model: "gpt-4",
+      messages: [{role: "user", content: prompt}]
+    )
+    
+    generated_content = ai_response.dig("choices", 0, "message", "content")
+    
+    # Store or send the generated content
+    user.notifications.create!(
+      title: "AI Generated Content Ready",
+      content: generated_content,
+      notification_type: prompt_identifier.split('/').last
+    )
+  end
+
+  private
+
+  def openai_client
+    @openai_client ||= OpenAI::Client.new(access_token: Rails.application.credentials.openai_api_key)
+  end
+end
+
+# Usage
+GenerateAiContentJob.perform_later(
+  user.id,
+  "coaching/goal_review",
+  {
+    current_goals: user.goals.active.pluck(:title),
+    progress_summary: "Made good progress on fitness goals",
+    challenges: ["Time management", "Consistency"]
+  }
+)
+```

data/wiki/Schema-Validation.md

@@ -0,0 +1,27 @@
+## Schema Validation
+
+Ensure all locals passed to templates match a defined schema, so missing or mistyped variables fail fast before sending to AI.
+
+### Schema File Next to Prompt
+
+For each prompt, create a `schema.yml` (or `.json`) file alongside the template.
+
+**Example:**
+
+`app/prompts/user_onboarding/welcome_email.schema.yml`
+
+```yml
+name: string
+app_name: string
+user_role: string
+features: array
+days_since_signup: integer
+```
+
+### Validation Layer in Promptly
+
+The validation is automatically triggered when you call `Promptly.render`. It will check for missing keys and (optionally) value types.
+
+Supported types: `string`, `integer`, `array`.
+
+If the validation fails, it will raise an `ArgumentError` for missing keys or a `TypeError` for mismatched types.

data/wiki/_Sidebar.md

@@ -0,0 +1,11 @@
+- [Home](https://github.com/wilburhimself/promptly/wiki)
+- [Quick Start](https://github.com/wilburhimself/promptly/wiki/Quick-Start)
+- [Schema Validation](https://github.com/wilburhimself/promptly/wiki/Schema-Validation)
+- [Helper: render_prompt](https://github.com/wilburhimself/promptly/wiki/Helper-render_prompt)
+- [Rails App Integration](https://github.com/wilburhimself/promptly/wiki/Rails-App-Integration)
+- [I18n Prompts Usage](https://github.com/wilburhimself/promptly/wiki/I18n-Prompts-Usage)
+- [Liquid Templates](https://github.com/wilburhimself/promptly/wiki/Liquid-Templates)
+- [Configuration](https://github.com/wilburhimself/promptly/wiki/Configuration)
+- [Generators](https://github.com/wilburhimself/promptly/wiki/Generators)
+- [Linting Templates](https://github.com/wilburhimself/promptly/wiki/Linting-Templates)
+- [Functional Prompt Tests](https://github.com/wilburhimself/promptly/wiki/Functional-Prompt-Tests)

metadata

@@ -1,29 +1,49 @@
 --- !ruby/object:Gem::Specification
 name: promptly
 version: !ruby/object:Gem::Version
-  version: 0.1.13
+  version: 0.1.21
 platform: ruby
 authors:
 - Wilbur Suero
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-18 00:00:00.000000000 Z
+date: 2026-03-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionview
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: json_schemer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -70,20 +90,26 @@ dependencies:
   name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 description: Build maintainable, localized, and testable AI prompts using ERB or Liquid
   templates with Rails conventions
 email:
-- wilbur@example.com
+- suerowilbur@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -94,6 +120,8 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- app/prompts/test/prompt.en.erb
+- app/prompts/test/prompt_with_metadata.en.erb
 - lib/generators/promptly/prompt_generator.rb
 - lib/promptly.rb
 - lib/promptly/cache.rb
@@ -102,7 +130,21 @@ files:
 - lib/promptly/railtie.rb
 - lib/promptly/renderer.rb
 - lib/promptly/tasks/ai_prompts.rake
+- lib/promptly/validator.rb
 - lib/promptly/version.rb
+- wiki/Configuration.md
+- wiki/Functional-Prompt-Tests.md
+- wiki/Generators.md
+- wiki/Helper-render_prompt.md
+- wiki/Home.md
+- wiki/I18n-Prompts-Usage.md
+- wiki/Linting-Templates.md
+- wiki/Liquid-Templates.md
+- wiki/Prompt-Version-Metadata.md
+- wiki/Quick-Start.md
+- wiki/Rails-App-Integration.md
+- wiki/Schema-Validation.md
+- wiki/_Sidebar.md
 homepage: https://github.com/wilburhimself/promptly
 licenses:
 - MIT