@dewtech/dare-cli 3.3.0 → 3.4.0

package/templates/stacks/ruby-rails-8/app/services/summarize_document_service.rb

@@ -1,57 +1,57 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — SummarizeDocumentService
-# Convention (ADR-01): single responsibility — load document, call LLM, persist summary, emit event
-#
-# Usage:
-#   result = Services::SummarizeDocumentService.new(
-#     document_repository: Repositories::DocumentRepository.new,
-#     llm_provider:        LLM::Providers::LLMProvider.instance,
-#     event_publisher:     RealtimeService.instance
-#   ).execute(document_id: "abc-123", user_id: 42)
-#
-# Returns: SummarizeDocumentService::Result (summary, document_id)
-# Raises:  Services::SummarizeDocumentService::DocumentNotFoundError
-#          Services::SummarizeDocumentService::SummarizationError
-
-module Services
-  class SummarizeDocumentService
-    # ── Domain errors ──────────────────────────────────────────────────────
-    DocumentNotFoundError = Class.new(StandardError)
-    SummarizationError    = Class.new(StandardError)
-
-    # ── Result ─────────────────────────────────────────────────────────────
-    Result = Struct.new(:summary, :document_id, keyword_init: true)
-
-    # ── Constructor ────────────────────────────────────────────────────────
-    def initialize(document_repository:, llm_provider:, event_publisher:)
-      @document_repository = document_repository
-      @llm_provider        = llm_provider
-      @event_publisher     = event_publisher
-    end
-
-    # ── Main operation ─────────────────────────────────────────────────────
-    def execute(document_id:, user_id:)
-      doc = @document_repository.find(document_id)
-      raise DocumentNotFoundError, "Document #{document_id} not found" if doc.nil?
-
-      prompt  = LLM::Prompts::PromptLoader.load("summarize_v1", content: doc.content, language: "pt-BR")
-      summary = @llm_provider.complete(model: "gpt-4o-mini", prompt: prompt)
-
-      raise SummarizationError, "LLM returned empty summary" if summary.blank?
-
-      @document_repository.update_summary!(doc, summary)
-
-      @event_publisher.publish(
-        type: "document.summarized",
-        data: {
-          document_id:    document_id,
-          user_id:        user_id,
-          summary_length: summary.length
-        }
-      )
-
-      Result.new(summary: summary, document_id: document_id)
-    end
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — SummarizeDocumentService
+# Convention (ADR-01): single responsibility — load document, call LLM, persist summary, emit event
+#
+# Usage:
+#   result = Services::SummarizeDocumentService.new(
+#     document_repository: Repositories::DocumentRepository.new,
+#     llm_provider:        LLM::Providers::LLMProvider.instance,
+#     event_publisher:     RealtimeService.instance
+#   ).execute(document_id: "abc-123", user_id: 42)
+#
+# Returns: SummarizeDocumentService::Result (summary, document_id)
+# Raises:  Services::SummarizeDocumentService::DocumentNotFoundError
+#          Services::SummarizeDocumentService::SummarizationError
+
+module Services
+  class SummarizeDocumentService
+    # ── Domain errors ──────────────────────────────────────────────────────
+    DocumentNotFoundError = Class.new(StandardError)
+    SummarizationError    = Class.new(StandardError)
+
+    # ── Result ─────────────────────────────────────────────────────────────
+    Result = Struct.new(:summary, :document_id, keyword_init: true)
+
+    # ── Constructor ────────────────────────────────────────────────────────
+    def initialize(document_repository:, llm_provider:, event_publisher:)
+      @document_repository = document_repository
+      @llm_provider        = llm_provider
+      @event_publisher     = event_publisher
+    end
+
+    # ── Main operation ─────────────────────────────────────────────────────
+    def execute(document_id:, user_id:)
+      doc = @document_repository.find(document_id)
+      raise DocumentNotFoundError, "Document #{document_id} not found" if doc.nil?
+
+      prompt  = LLM::Prompts::PromptLoader.load("summarize_v1", content: doc.content, language: "pt-BR")
+      summary = @llm_provider.complete(model: "gpt-4o-mini", prompt: prompt)
+
+      raise SummarizationError, "LLM returned empty summary" if summary.blank?
+
+      @document_repository.update_summary!(doc, summary)
+
+      @event_publisher.publish(
+        type: "document.summarized",
+        data: {
+          document_id:    document_id,
+          user_id:        user_id,
+          summary_length: summary.length
+        }
+      )
+
+      Result.new(summary: summary, document_id: document_id)
+    end
+  end
+end

package/templates/stacks/ruby-rails-8/config/dare.yml

@@ -1,42 +1,42 @@
-# DARE v3.0 — Application configuration
-# Access in Ruby via: Rails.configuration.dare
-# Environment-specific settings override the "default" block.
-
-default: &default
-  llm:
-    provider: dummy          # dummy | openai | local_llama
-    model: gpt-4o
-    # api_key: set via OPENAI_API_KEY env var (never in source)
-
-  rate_limit:
-    rpm: 100                 # requests per minute per IP (public API)
-    auth_rpm: 10             # requests per minute per IP (auth endpoints)
-    llm_rpm: 20              # requests per minute per user (LLM endpoints)
-
-  openapi:
-    enabled: true
-    output_path: public/openapi.json
-    title: "<%= app_name %> API"
-    version: "1.0.0"
-    description: "REST API built with Rails 8 + DARE v3.0"
-
-  realtime:
-    backend: action_cable    # action_cable | sucker_punch
-    redis_url: <%= ENV.fetch('REDIS_URL', 'redis://localhost:6379/0') %>
-
-development:
-  <<: *default
-  llm:
-    provider: dummy
-
-test:
-  <<: *default
-  llm:
-    provider: dummy
-  rate_limit:
-    rpm: 10000               # effectively unlimited in tests
-
-production:
-  <<: *default
-  llm:
-    provider: openai         # set OPENAI_API_KEY in environment
+# DARE v3.0 — Application configuration
+# Access in Ruby via: Rails.configuration.dare
+# Environment-specific settings override the "default" block.
+
+default: &default
+  llm:
+    provider: dummy          # dummy | openai | local_llama
+    model: gpt-4o
+    # api_key: set via OPENAI_API_KEY env var (never in source)
+
+  rate_limit:
+    rpm: 100                 # requests per minute per IP (public API)
+    auth_rpm: 10             # requests per minute per IP (auth endpoints)
+    llm_rpm: 20              # requests per minute per user (LLM endpoints)
+
+  openapi:
+    enabled: true
+    output_path: public/openapi.json
+    title: "<%= app_name %> API"
+    version: "1.0.0"
+    description: "REST API built with Rails 8 + DARE v3.0"
+
+  realtime:
+    backend: action_cable    # action_cable | sucker_punch
+    redis_url: <%= ENV.fetch('REDIS_URL', 'redis://localhost:6379/0') %>
+
+development:
+  <<: *default
+  llm:
+    provider: dummy
+
+test:
+  <<: *default
+  llm:
+    provider: dummy
+  rate_limit:
+    rpm: 10000               # effectively unlimited in tests
+
+production:
+  <<: *default
+  llm:
+    provider: openai         # set OPENAI_API_KEY in environment

package/templates/stacks/ruby-rails-8/config/initializers/dare.rb

@@ -1,31 +1,31 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — Central configuration initializer
-# All DARE runtime settings are loaded from config/dare.yml
-# Access via: Rails.configuration.dare
-
-dare_config_path = Rails.root.join("config", "dare.yml")
-
-if dare_config_path.exist?
-  raw = YAML.safe_load_file(dare_config_path, symbolize_names: false)
-  env_config = raw.dig(Rails.env) || raw["default"] || {}
-
-  Rails.configuration.dare = OpenStruct.new(
-    llm_provider:   env_config.dig("llm", "provider") || "dummy",
-    llm_model:      env_config.dig("llm", "model")    || "gpt-4o",
-    llm_api_key:    ENV.fetch("OPENAI_API_KEY", nil),
-    redis_url:      ENV.fetch("REDIS_URL", "redis://localhost:6379/0"),
-    rate_limit_rpm: env_config.dig("rate_limit", "rpm") || 100,
-    metrics_path:   Rails.root.join("tmp", "dare_metrics.json")
-  )
-else
-  Rails.logger.warn "[DARE] config/dare.yml not found — using defaults"
-  Rails.configuration.dare = OpenStruct.new(
-    llm_provider:   "dummy",
-    llm_model:      "gpt-4o",
-    llm_api_key:    ENV.fetch("OPENAI_API_KEY", nil),
-    redis_url:      ENV.fetch("REDIS_URL", "redis://localhost:6379/0"),
-    rate_limit_rpm: 100,
-    metrics_path:   Rails.root.join("tmp", "dare_metrics.json")
-  )
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — Central configuration initializer
+# All DARE runtime settings are loaded from config/dare.yml
+# Access via: Rails.configuration.dare
+
+dare_config_path = Rails.root.join("config", "dare.yml")
+
+if dare_config_path.exist?
+  raw = YAML.safe_load_file(dare_config_path, symbolize_names: false)
+  env_config = raw.dig(Rails.env) || raw["default"] || {}
+
+  Rails.configuration.dare = OpenStruct.new(
+    llm_provider:   env_config.dig("llm", "provider") || "dummy",
+    llm_model:      env_config.dig("llm", "model")    || "gpt-4o",
+    llm_api_key:    ENV.fetch("OPENAI_API_KEY", nil),
+    redis_url:      ENV.fetch("REDIS_URL", "redis://localhost:6379/0"),
+    rate_limit_rpm: env_config.dig("rate_limit", "rpm") || 100,
+    metrics_path:   Rails.root.join("tmp", "dare_metrics.json")
+  )
+else
+  Rails.logger.warn "[DARE] config/dare.yml not found — using defaults"
+  Rails.configuration.dare = OpenStruct.new(
+    llm_provider:   "dummy",
+    llm_model:      "gpt-4o",
+    llm_api_key:    ENV.fetch("OPENAI_API_KEY", nil),
+    redis_url:      ENV.fetch("REDIS_URL", "redis://localhost:6379/0"),
+    rate_limit_rpm: 100,
+    metrics_path:   Rails.root.join("tmp", "dare_metrics.json")
+  )
+end

package/templates/stacks/ruby-rails-8/config/initializers/rack_attack.rb

@@ -1,64 +1,64 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — Rack::Attack configuration
-# Satisfies metric M-04: 100% of public endpoints have rate limit configured
-#
-# D-006 (RFC 7807): throttle responses use Problem Details format
-
-class Rack::Attack
-  # ── Safelist ───────────────────────────────────────────────────────────────
-  # Always allow localhost in development
-  safelist("allow-localhost") do |req|
-    req.ip == "127.0.0.1" || req.ip == "::1" if Rails.env.development?
-  end
-
-  # ── Public API throttle ───────────────────────────────────────────────────
-  # M-04: All public endpoints limited to 100 req/min per IP
-  throttle("public-api/ip", limit: 100, period: 1.minute) do |req|
-    req.ip if req.path.start_with?("/api/")
-  end
-
-  # ── Auth endpoints throttle ───────────────────────────────────────────────
-  # 10 req/min per IP for sensitive auth endpoints
-  throttle("auth/ip", limit: 10, period: 1.minute) do |req|
-    req.ip if req.path =~ %r{\A/api/(auth|sessions|passwords)}
-  end
-
-  # ── LLM endpoints throttle ───────────────────────────────────────────────
-  # 20 req/min per authenticated user for LLM-heavy endpoints
-  throttle("llm/user", limit: 20, period: 1.minute) do |req|
-    req.env["HTTP_X_USER_ID"] if req.path.start_with?("/api/") && req.env["HTTP_X_USER_ID"]
-  end
-
-  # ── Response — RFC 7807 Problem Details ───────────────────────────────────
-  self.throttled_responder = lambda do |env|
-    match_data = env["rack.attack.match_data"]
-    now        = match_data[:epoch_time]
-    retry_at   = now + (match_data[:period] - now % match_data[:period])
-
-    headers = {
-      "Content-Type"  => "application/problem+json",
-      "Retry-After"   => (retry_at - now).to_s,
-      "X-RateLimit-Limit"     => match_data[:limit].to_s,
-      "X-RateLimit-Remaining" => "0",
-      "X-RateLimit-Reset"     => retry_at.to_s,
-    }
-
-    body = {
-      type:     "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429",
-      title:    "Too Many Requests",
-      status:   429,
-      detail:   "Rate limit exceeded. Please retry after #{retry_at - now} seconds.",
-      instance: env["PATH_INFO"],
-    }.to_json
-
-    [429, headers, [body]]
-  end
-end
-
-# Use Redis for distributed rate limiting (multi-server setups)
-if defined?(Redis) && ENV["REDIS_URL"]
-  Rack::Attack.cache.store = ActiveSupport::Cache::RedisCacheStore.new(
-    url: ENV["REDIS_URL"]
-  )
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — Rack::Attack configuration
+# Satisfies metric M-04: 100% of public endpoints have rate limit configured
+#
+# D-006 (RFC 7807): throttle responses use Problem Details format
+
+class Rack::Attack
+  # ── Safelist ───────────────────────────────────────────────────────────────
+  # Always allow localhost in development
+  safelist("allow-localhost") do |req|
+    req.ip == "127.0.0.1" || req.ip == "::1" if Rails.env.development?
+  end
+
+  # ── Public API throttle ───────────────────────────────────────────────────
+  # M-04: All public endpoints limited to 100 req/min per IP
+  throttle("public-api/ip", limit: 100, period: 1.minute) do |req|
+    req.ip if req.path.start_with?("/api/")
+  end
+
+  # ── Auth endpoints throttle ───────────────────────────────────────────────
+  # 10 req/min per IP for sensitive auth endpoints
+  throttle("auth/ip", limit: 10, period: 1.minute) do |req|
+    req.ip if req.path =~ %r{\A/api/(auth|sessions|passwords)}
+  end
+
+  # ── LLM endpoints throttle ───────────────────────────────────────────────
+  # 20 req/min per authenticated user for LLM-heavy endpoints
+  throttle("llm/user", limit: 20, period: 1.minute) do |req|
+    req.env["HTTP_X_USER_ID"] if req.path.start_with?("/api/") && req.env["HTTP_X_USER_ID"]
+  end
+
+  # ── Response — RFC 7807 Problem Details ───────────────────────────────────
+  self.throttled_responder = lambda do |env|
+    match_data = env["rack.attack.match_data"]
+    now        = match_data[:epoch_time]
+    retry_at   = now + (match_data[:period] - now % match_data[:period])
+
+    headers = {
+      "Content-Type"  => "application/problem+json",
+      "Retry-After"   => (retry_at - now).to_s,
+      "X-RateLimit-Limit"     => match_data[:limit].to_s,
+      "X-RateLimit-Remaining" => "0",
+      "X-RateLimit-Reset"     => retry_at.to_s,
+    }
+
+    body = {
+      type:     "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429",
+      title:    "Too Many Requests",
+      status:   429,
+      detail:   "Rate limit exceeded. Please retry after #{retry_at - now} seconds.",
+      instance: env["PATH_INFO"],
+    }.to_json
+
+    [429, headers, [body]]
+  end
+end
+
+# Use Redis for distributed rate limiting (multi-server setups)
+if defined?(Redis) && ENV["REDIS_URL"]
+  Rack::Attack.cache.store = ActiveSupport::Cache::RedisCacheStore.new(
+    url: ENV["REDIS_URL"]
+  )
+end

package/templates/stacks/ruby-rails-8/config/initializers/rswag_api.rb

@@ -1,12 +1,12 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — rswag API configuration
-# Satisfies metric M-02: 100% of endpoints have OpenAPI documentation
-
-Rswag::Api.configure do |c|
-  # Path to the generated openapi.json spec file
-  c.openapi_root = Rails.root.join("public").to_s
-
-  # Authorize all endpoints in Swagger UI with Bearer token by default
-  c.swagger_filter = lambda { |swagger, env| swagger }
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — rswag API configuration
+# Satisfies metric M-02: 100% of endpoints have OpenAPI documentation
+
+Rswag::Api.configure do |c|
+  # Path to the generated openapi.json spec file
+  c.openapi_root = Rails.root.join("public").to_s
+
+  # Authorize all endpoints in Swagger UI with Bearer token by default
+  c.swagger_filter = lambda { |swagger, env| swagger }
+end