@dewtech/dare-cli 3.3.0 → 3.4.0

package/templates/stacks/ruby-rails-8/app/controllers/concerns/problem_details.rb

@@ -1,93 +1,93 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — RFC 7807 Problem Details concern
-# Decision: D-006 — all HTTP errors use this format
-#
-# Usage: include ProblemDetails in ApplicationController
-#
-# Format:
-#   {
-#     "type":     "https://example.com/problems/not-found",
-#     "title":    "Resource Not Found",
-#     "status":   404,
-#     "detail":   "User with id=42 was not found.",
-#     "instance": "/api/users/42"
-#   }
-
-module ProblemDetails
-  extend ActiveSupport::Concern
-
-  included do
-    rescue_from StandardError,                    with: :render_internal_error
-    rescue_from ActiveRecord::RecordNotFound,     with: :render_not_found
-    rescue_from ActiveRecord::RecordInvalid,      with: :render_unprocessable_entity
-    rescue_from ActionController::ParameterMissing, with: :render_bad_request
-    rescue_from ArgumentError,                    with: :render_bad_request
-  end
-
-  # ── Public helpers ──────────────────────────────────────────────────────────
-
-  # Render a Problem Details response manually.
-  #
-  #   render_problem(status: :not_found, title: "User Not Found", detail: "...")
-  def render_problem(status:, title:, detail: nil, type: nil, **extra)
-    http_status = Rack::Utils.status_code(status)
-
-    body = {
-      type:     type || default_type_uri(http_status),
-      title:    title,
-      status:   http_status,
-      detail:   detail,
-      instance: request.path,
-    }.merge(extra).compact
-
-    render json: body,
-           status: http_status,
-           content_type: "application/problem+json"
-  end
-
-  private
-
-  def render_not_found(exception)
-    render_problem(
-      status: :not_found,
-      title:  "Not Found",
-      detail: exception.message.presence || "The requested resource does not exist."
-    )
-  end
-
-  def render_unprocessable_entity(exception)
-    errors = exception.record&.errors&.full_messages || [exception.message]
-    render_problem(
-      status:  :unprocessable_entity,
-      title:   "Validation Failed",
-      detail:  "One or more fields failed validation.",
-      errors:  errors
-    )
-  end
-
-  def render_bad_request(exception)
-    render_problem(
-      status: :bad_request,
-      title:  "Bad Request",
-      detail: exception.message
-    )
-  end
-
-  def render_internal_error(exception)
-    # Never leak internals in production
-    detail = Rails.env.production? ? "An unexpected error occurred." : exception.message
-
-    Rails.logger.error "[ProblemDetails] #{exception.class}: #{exception.message}\n#{exception.backtrace&.first(10)&.join("\n")}"
-
-    render_problem(
-      status: :internal_server_error,
-      title:  "Internal Server Error",
-      detail: detail
-    )
-  end
-
-  def default_type_uri(status_code)
-    "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/#{status_code}"
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — RFC 7807 Problem Details concern
+# Decision: D-006 — all HTTP errors use this format
+#
+# Usage: include ProblemDetails in ApplicationController
+#
+# Format:
+#   {
+#     "type":     "https://example.com/problems/not-found",
+#     "title":    "Resource Not Found",
+#     "status":   404,
+#     "detail":   "User with id=42 was not found.",
+#     "instance": "/api/users/42"
+#   }
+
+module ProblemDetails
+  extend ActiveSupport::Concern
+
+  included do
+    rescue_from StandardError,                    with: :render_internal_error
+    rescue_from ActiveRecord::RecordNotFound,     with: :render_not_found
+    rescue_from ActiveRecord::RecordInvalid,      with: :render_unprocessable_entity
+    rescue_from ActionController::ParameterMissing, with: :render_bad_request
+    rescue_from ArgumentError,                    with: :render_bad_request
+  end
+
+  # ── Public helpers ──────────────────────────────────────────────────────────
+
+  # Render a Problem Details response manually.
+  #
+  #   render_problem(status: :not_found, title: "User Not Found", detail: "...")
+  def render_problem(status:, title:, detail: nil, type: nil, **extra)
+    http_status = Rack::Utils.status_code(status)
+
+    body = {
+      type:     type || default_type_uri(http_status),
+      title:    title,
+      status:   http_status,
+      detail:   detail,
+      instance: request.path,
+    }.merge(extra).compact
+
+    render json: body,
+           status: http_status,
+           content_type: "application/problem+json"
+  end
+
+  private
+
+  def render_not_found(exception)
+    render_problem(
+      status: :not_found,
+      title:  "Not Found",
+      detail: exception.message.presence || "The requested resource does not exist."
+    )
+  end
+
+  def render_unprocessable_entity(exception)
+    errors = exception.record&.errors&.full_messages || [exception.message]
+    render_problem(
+      status:  :unprocessable_entity,
+      title:   "Validation Failed",
+      detail:  "One or more fields failed validation.",
+      errors:  errors
+    )
+  end
+
+  def render_bad_request(exception)
+    render_problem(
+      status: :bad_request,
+      title:  "Bad Request",
+      detail: exception.message
+    )
+  end
+
+  def render_internal_error(exception)
+    # Never leak internals in production
+    detail = Rails.env.production? ? "An unexpected error occurred." : exception.message
+
+    Rails.logger.error "[ProblemDetails] #{exception.class}: #{exception.message}\n#{exception.backtrace&.first(10)&.join("\n")}"
+
+    render_problem(
+      status: :internal_server_error,
+      title:  "Internal Server Error",
+      detail: detail
+    )
+  end
+
+  def default_type_uri(status_code)
+    "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/#{status_code}"
+  end
+end

package/templates/stacks/ruby-rails-8/app/handlers/summarize_handler.rb

@@ -1,33 +1,33 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — SummarizeHandler (thin controller, delegates to service)
-# Convention (ADR-01): HTTP concerns only — params, response codes, delegation
-# No business logic here.
-#
-# POST /api/v1/documents/:id/summarize
-# RFC 7807 errors via ProblemDetails concern (D-006)
-
-class SummarizeHandler < ApplicationController
-  include ProblemDetails
-
-  before_action :authenticate_user!  # assume Devise or similar
-
-  # POST /api/v1/documents/:id/summarize
-  def create
-    result = Services::SummarizeDocumentService.new(
-      document_repository: Repositories::DocumentRepository.new,
-      llm_provider:        LLM::Providers::LLMProvider.instance,
-      event_publisher:     RealtimeService.instance
-    ).execute(
-      document_id: params[:id],
-      user_id:     current_user.id
-    )
-
-    render json: { summary: result.summary, document_id: result.document_id }, status: :ok
-
-  rescue Services::SummarizeDocumentService::DocumentNotFoundError => e
-    render_problem(status: 404, title: "Not Found", detail: e.message)
-  rescue Services::SummarizeDocumentService::SummarizationError => e
-    render_problem(status: 422, title: "Summarization Failed", detail: e.message)
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — SummarizeHandler (thin controller, delegates to service)
+# Convention (ADR-01): HTTP concerns only — params, response codes, delegation
+# No business logic here.
+#
+# POST /api/v1/documents/:id/summarize
+# RFC 7807 errors via ProblemDetails concern (D-006)
+
+class SummarizeHandler < ApplicationController
+  include ProblemDetails
+
+  before_action :authenticate_user!  # assume Devise or similar
+
+  # POST /api/v1/documents/:id/summarize
+  def create
+    result = Services::SummarizeDocumentService.new(
+      document_repository: Repositories::DocumentRepository.new,
+      llm_provider:        LLM::Providers::LLMProvider.instance,
+      event_publisher:     RealtimeService.instance
+    ).execute(
+      document_id: params[:id],
+      user_id:     current_user.id
+    )
+
+    render json: { summary: result.summary, document_id: result.document_id }, status: :ok
+
+  rescue Services::SummarizeDocumentService::DocumentNotFoundError => e
+    render_problem(status: 404, title: "Not Found", detail: e.message)
+  rescue Services::SummarizeDocumentService::SummarizationError => e
+    render_problem(status: 422, title: "Summarization Failed", detail: e.message)
+  end
+end

package/templates/stacks/ruby-rails-8/app/handlers/users_handler.rb

@@ -1,68 +1,68 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — UsersHandler (thin controller)
-# Convention (ADR-01): HTTP concerns only — params, response codes, delegation
-# No business logic, no repository calls, no queries here.
-
-class UsersHandler < ApplicationController
-  before_action :require_authentication!, only: %i[update destroy]
-
-  # GET /api/users
-  def index
-    repo  = Repositories::UserRepository.new
-    users = repo.all_active
-
-    render json: UserPresenter.collection(users), status: :ok
-  end
-
-  # GET /api/users/:id
-  def show
-    repo = Repositories::UserRepository.new
-    user = repo.find!(params[:id])
-
-    render json: UserPresenter.new(user).as_json, status: :ok
-  end
-
-  # POST /api/users
-  def create
-    input = params.require(:user).permit(:email, :name, :password)
-
-    user = Services::CreateUserService.new(
-      user_repository: Repositories::UserRepository.new,
-      event_publisher: RealtimeService.instance
-    ).execute(
-      email:    input[:email],
-      name:     input[:name],
-      password: input[:password]
-    )
-
-    render json: UserPresenter.new(user).as_json, status: :created
-
-  rescue Services::CreateUserService::EmailTakenError => e
-    render_problem(
-      status: :conflict,
-      title:  "Email Already Taken",
-      detail: e.message
-    )
-  end
-
-  # PATCH /api/users/:id
-  def update
-    repo  = Repositories::UserRepository.new
-    user  = repo.find!(params[:id])
-    input = params.require(:user).permit(:name)
-
-    repo.update!(user, input.to_h)
-
-    render json: UserPresenter.new(user).as_json, status: :ok
-  end
-
-  # DELETE /api/users/:id
-  def destroy
-    repo = Repositories::UserRepository.new
-    user = repo.find!(params[:id])
-    repo.destroy!(user)
-
-    head :no_content
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — UsersHandler (thin controller)
+# Convention (ADR-01): HTTP concerns only — params, response codes, delegation
+# No business logic, no repository calls, no queries here.
+
+class UsersHandler < ApplicationController
+  before_action :require_authentication!, only: %i[update destroy]
+
+  # GET /api/users
+  def index
+    repo  = Repositories::UserRepository.new
+    users = repo.all_active
+
+    render json: UserPresenter.collection(users), status: :ok
+  end
+
+  # GET /api/users/:id
+  def show
+    repo = Repositories::UserRepository.new
+    user = repo.find!(params[:id])
+
+    render json: UserPresenter.new(user).as_json, status: :ok
+  end
+
+  # POST /api/users
+  def create
+    input = params.require(:user).permit(:email, :name, :password)
+
+    user = Services::CreateUserService.new(
+      user_repository: Repositories::UserRepository.new,
+      event_publisher: RealtimeService.instance
+    ).execute(
+      email:    input[:email],
+      name:     input[:name],
+      password: input[:password]
+    )
+
+    render json: UserPresenter.new(user).as_json, status: :created
+
+  rescue Services::CreateUserService::EmailTakenError => e
+    render_problem(
+      status: :conflict,
+      title:  "Email Already Taken",
+      detail: e.message
+    )
+  end
+
+  # PATCH /api/users/:id
+  def update
+    repo  = Repositories::UserRepository.new
+    user  = repo.find!(params[:id])
+    input = params.require(:user).permit(:name)
+
+    repo.update!(user, input.to_h)
+
+    render json: UserPresenter.new(user).as_json, status: :ok
+  end
+
+  # DELETE /api/users/:id
+  def destroy
+    repo = Repositories::UserRepository.new
+    user = repo.find!(params[:id])
+    repo.destroy!(user)
+
+    head :no_content
+  end
+end

package/templates/stacks/ruby-rails-8/app/llm/cache/llm_cache.rb

@@ -1,44 +1,44 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — LLM Cache (Redis wrapper)
-# Caches LLM responses to reduce API costs and latency
-# Uses SHA256 of (model + prompt) as cache key
-#
-# Usage:
-#   result = LLM::Cache::LlmCache.instance.fetch(model: "gpt-4o", prompt: prompt) do
-#     LLMProvider.instance.complete(model: "gpt-4o", prompt: prompt)
-#   end
-
-module LLM
-  module Cache
-    class LlmCache
-      include Singleton
-
-      DEFAULT_TTL = 24.hours
-
-      def fetch(model:, prompt:, ttl: DEFAULT_TTL, &block)
-        key = cache_key(model, prompt)
-
-        Rails.cache.fetch(key, expires_in: ttl, &block)
-      end
-
-      def invalidate(model:, prompt:)
-        key = cache_key(model, prompt)
-        Rails.cache.delete(key)
-      end
-
-      def clear_all!
-        # WARNING: clears entire Rails cache — use only in test/dev
-        raise "clear_all! not allowed in production!" if Rails.env.production?
-        Rails.cache.clear
-      end
-
-      private
-
-      def cache_key(model, prompt)
-        hash = Digest::SHA256.hexdigest("#{model}:#{prompt}")
-        "llm_cache:#{hash}"
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — LLM Cache (Redis wrapper)
+# Caches LLM responses to reduce API costs and latency
+# Uses SHA256 of (model + prompt) as cache key
+#
+# Usage:
+#   result = LLM::Cache::LlmCache.instance.fetch(model: "gpt-4o", prompt: prompt) do
+#     LLMProvider.instance.complete(model: "gpt-4o", prompt: prompt)
+#   end
+
+module LLM
+  module Cache
+    class LlmCache
+      include Singleton
+
+      DEFAULT_TTL = 24.hours
+
+      def fetch(model:, prompt:, ttl: DEFAULT_TTL, &block)
+        key = cache_key(model, prompt)
+
+        Rails.cache.fetch(key, expires_in: ttl, &block)
+      end
+
+      def invalidate(model:, prompt:)
+        key = cache_key(model, prompt)
+        Rails.cache.delete(key)
+      end
+
+      def clear_all!
+        # WARNING: clears entire Rails cache — use only in test/dev
+        raise "clear_all! not allowed in production!" if Rails.env.production?
+        Rails.cache.clear
+      end
+
+      private
+
+      def cache_key(model, prompt)
+        hash = Digest::SHA256.hexdigest("#{model}:#{prompt}")
+        "llm_cache:#{hash}"
+      end
+    end
+  end
+end

package/templates/stacks/ruby-rails-8/app/llm/prompts/prompt_loader.rb

@@ -1,54 +1,54 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — PromptLoader
-# Loads .txt or .jinja2 prompt templates from app/llm/prompts/
-# Performs simple variable interpolation
-#
-# Usage:
-#   prompt = LLM::Prompts::PromptLoader.load("summarize", "v1", text: "Long document text...")
-#   response = LLMProvider.instance.complete(model: "gpt-4o", prompt: prompt)
-
-module LLM
-  module Prompts
-    class PromptLoader
-      PROMPTS_DIR = Rails.root.join("app", "llm", "prompts")
-
-      # Load a prompt template and interpolate variables.
-      #
-      # @param name     [String] template name (e.g. "summarize")
-      # @param version  [String] version suffix (e.g. "v1")
-      # @param vars     [Hash]   variables to interpolate into the template
-      # @return [String] rendered prompt
-      def self.load(name, version = "v1", **vars)
-        template = find_template!(name, version)
-        interpolate(template, vars)
-      end
-
-      private_class_method def self.find_template!(name, version)
-        # Search order: .jinja2 first, then .txt, then .erb
-        candidates = [
-          PROMPTS_DIR.join("#{name}_#{version}.jinja2"),
-          PROMPTS_DIR.join("#{name}_#{version}.txt"),
-          PROMPTS_DIR.join("#{name}.jinja2"),
-          PROMPTS_DIR.join("#{name}.txt"),
-        ]
-
-        path = candidates.find(&:exist?)
-        raise ArgumentError, "Prompt template not found: #{name}/#{version}. Searched:\n#{candidates.map(&:to_s).join("\n")}" unless path
-
-        path.read
-      end
-
-      # Simple variable interpolation: {{ variable_name }} syntax (Jinja2-compatible)
-      # Also supports <%= variable_name %> (ERB) and {{variable_name}} without spaces
-      private_class_method def self.interpolate(template, vars)
-        result = template.dup
-        vars.each do |key, value|
-          result.gsub!(/\{\{\s*#{Regexp.escape(key.to_s)}\s*\}\}/, value.to_s)
-          result.gsub!(/<%=\s*#{Regexp.escape(key.to_s)}\s*%>/, value.to_s)
-        end
-        result
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — PromptLoader
+# Loads .txt or .jinja2 prompt templates from app/llm/prompts/
+# Performs simple variable interpolation
+#
+# Usage:
+#   prompt = LLM::Prompts::PromptLoader.load("summarize", "v1", text: "Long document text...")
+#   response = LLMProvider.instance.complete(model: "gpt-4o", prompt: prompt)
+
+module LLM
+  module Prompts
+    class PromptLoader
+      PROMPTS_DIR = Rails.root.join("app", "llm", "prompts")
+
+      # Load a prompt template and interpolate variables.
+      #
+      # @param name     [String] template name (e.g. "summarize")
+      # @param version  [String] version suffix (e.g. "v1")
+      # @param vars     [Hash]   variables to interpolate into the template
+      # @return [String] rendered prompt
+      def self.load(name, version = "v1", **vars)
+        template = find_template!(name, version)
+        interpolate(template, vars)
+      end
+
+      private_class_method def self.find_template!(name, version)
+        # Search order: .jinja2 first, then .txt, then .erb
+        candidates = [
+          PROMPTS_DIR.join("#{name}_#{version}.jinja2"),
+          PROMPTS_DIR.join("#{name}_#{version}.txt"),
+          PROMPTS_DIR.join("#{name}.jinja2"),
+          PROMPTS_DIR.join("#{name}.txt"),
+        ]
+
+        path = candidates.find(&:exist?)
+        raise ArgumentError, "Prompt template not found: #{name}/#{version}. Searched:\n#{candidates.map(&:to_s).join("\n")}" unless path
+
+        path.read
+      end
+
+      # Simple variable interpolation: {{ variable_name }} syntax (Jinja2-compatible)
+      # Also supports <%= variable_name %> (ERB) and {{variable_name}} without spaces
+      private_class_method def self.interpolate(template, vars)
+        result = template.dup
+        vars.each do |key, value|
+          result.gsub!(/\{\{\s*#{Regexp.escape(key.to_s)}\s*\}\}/, value.to_s)
+          result.gsub!(/<%=\s*#{Regexp.escape(key.to_s)}\s*%>/, value.to_s)
+        end
+        result
+      end
+    end
+  end
+end

package/templates/stacks/ruby-rails-8/app/llm/prompts/summarize_v1.jinja2

@@ -1,12 +1,12 @@
-You are a professional document summarizer. Summarize the following text concisely.
-
-Rules:
-- Be factual and objective
-- Keep the summary under 150 words
-- Preserve the main ideas and key facts
-- Use plain language
-
-Text to summarize:
-{{ text }}
-
-Summary:
+You are a professional document summarizer. Summarize the following text concisely.
+
+Rules:
+- Be factual and objective
+- Keep the summary under 150 words
+- Preserve the main ideas and key facts
+- Use plain language
+
+Text to summarize:
+{{ text }}
+
+Summary: