@dewtech/dare-cli 3.3.0 → 3.4.0

package/templates/stacks/ruby-rails-8/app/models/user.rb

@@ -1,36 +1,36 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — User domain model
-# Convention (ADR-05): models are lean data objects — no callbacks, no fat model
-# Business logic lives in app/services/; data access in app/repositories/
-
-class User < ApplicationRecord
-  # ── Validations ─────────────────────────────────────────────────────────
-  validates :email, presence: true,
-                    uniqueness: { case_sensitive: false },
-                    format: { with: URI::MailTo::EMAIL_REGEXP }
-  validates :name,  presence: true, length: { minimum: 2, maximum: 100 }
-
-  # ── Scopes ───────────────────────────────────────────────────────────────
-  scope :active, -> { where(active: true) }
-
-  # ── DARE: NO callbacks, NO fat model logic ───────────────────────────────
-  # Use Services for: password hashing, welcome emails, event publishing, etc.
-  # Use Repositories for: queries, bulk updates, custom SQL
-  #
-  # WRONG (fat model):
-  #   before_create :send_welcome_email
-  #   after_save    :publish_event
-  #
-  # RIGHT (service):
-  #   Services::CreateUserService.new(...).execute(params)
-
-  # ── Simple domain helpers (pure data concerns only) ──────────────────────
-  def display_name
-    name.presence || email.split("@").first
-  end
-
-  def can_view?(user_id)
-    id == user_id.to_i || admin?
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — User domain model
+# Convention (ADR-05): models are lean data objects — no callbacks, no fat model
+# Business logic lives in app/services/; data access in app/repositories/
+
+class User < ApplicationRecord
+  # ── Validations ─────────────────────────────────────────────────────────
+  validates :email, presence: true,
+                    uniqueness: { case_sensitive: false },
+                    format: { with: URI::MailTo::EMAIL_REGEXP }
+  validates :name,  presence: true, length: { minimum: 2, maximum: 100 }
+
+  # ── Scopes ───────────────────────────────────────────────────────────────
+  scope :active, -> { where(active: true) }
+
+  # ── DARE: NO callbacks, NO fat model logic ───────────────────────────────
+  # Use Services for: password hashing, welcome emails, event publishing, etc.
+  # Use Repositories for: queries, bulk updates, custom SQL
+  #
+  # WRONG (fat model):
+  #   before_create :send_welcome_email
+  #   after_save    :publish_event
+  #
+  # RIGHT (service):
+  #   Services::CreateUserService.new(...).execute(params)
+
+  # ── Simple domain helpers (pure data concerns only) ──────────────────────
+  def display_name
+    name.presence || email.split("@").first
+  end
+
+  def can_view?(user_id)
+    id == user_id.to_i || admin?
+  end
+end

package/templates/stacks/ruby-rails-8/app/presenters/user_presenter.rb

@@ -1,48 +1,48 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — UserPresenter
-# Convention (ADR-05): serialization concern isolated from model and controller
-# Returns plain Hash; handler renders JSON from it
-
-class UserPresenter
-  def initialize(user)
-    @user = user
-  end
-
-  # Full representation — used in show/create responses
-  def as_json(*)
-    {
-      id:         @user.id,
-      email:      @user.email,
-      name:       @user.name,
-      active:     @user.active?,
-      created_at: @user.created_at&.iso8601,
-      updated_at: @user.updated_at&.iso8601,
-    }
-  end
-
-  def to_json(*)
-    as_json.to_json
-  end
-
-  # Collection representation — used in index responses
-  # Wraps an array of presenters into a standard envelope
-  def self.collection(users, meta: {})
-    {
-      data: users.map { |u| new(u).as_json },
-      meta: {
-        count: users.size,
-        **meta
-      }
-    }
-  end
-
-  # Minimal summary representation (e.g. for nested resources)
-  def summary
-    {
-      id:    @user.id,
-      email: @user.email,
-      name:  @user.name
-    }
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — UserPresenter
+# Convention (ADR-05): serialization concern isolated from model and controller
+# Returns plain Hash; handler renders JSON from it
+
+class UserPresenter
+  def initialize(user)
+    @user = user
+  end
+
+  # Full representation — used in show/create responses
+  def as_json(*)
+    {
+      id:         @user.id,
+      email:      @user.email,
+      name:       @user.name,
+      active:     @user.active?,
+      created_at: @user.created_at&.iso8601,
+      updated_at: @user.updated_at&.iso8601,
+    }
+  end
+
+  def to_json(*)
+    as_json.to_json
+  end
+
+  # Collection representation — used in index responses
+  # Wraps an array of presenters into a standard envelope
+  def self.collection(users, meta: {})
+    {
+      data: users.map { |u| new(u).as_json },
+      meta: {
+        count: users.size,
+        **meta
+      }
+    }
+  end
+
+  # Minimal summary representation (e.g. for nested resources)
+  def summary
+    {
+      id:    @user.id,
+      email: @user.email,
+      name:  @user.name
+    }
+  end
+end

package/templates/stacks/ruby-rails-8/app/repositories/document_repository.rb

@@ -1,57 +1,57 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — DocumentRepository (interface + ActiveRecord implementation)
-# Convention (ADR-05): data access is isolated here — services never call AR directly
-# This enables easy mocking in unit tests and future DB swaps
-
-module Repositories
-  class DocumentRepository
-    # ── Query ──────────────────────────────────────────────────────────────
-
-    def find(id)
-      Document.find_by(id: id)
-    end
-
-    def find!(id)
-      Document.find(id)
-    rescue ActiveRecord::RecordNotFound
-      raise ActiveRecord::RecordNotFound, "Document with id=#{id} was not found."
-    end
-
-    def all
-      Document.order(created_at: :desc)
-    end
-
-    def by_user(user_id)
-      Document.where(user_id: user_id).order(created_at: :desc)
-    end
-
-    # ── Persistence ────────────────────────────────────────────────────────
-
-    # Builds a new Document (not persisted).
-    def build(attrs = {})
-      Document.new(attrs)
-    end
-
-    # Persist (create or update). Raises ActiveRecord::RecordInvalid on failure.
-    def save!(document)
-      document.save!
-      document
-    end
-
-    # Update summary and timestamp after LLM processing.
-    def update_summary!(document, summary)
-      document.update!(summary: summary, summarized_at: Time.current)
-      document
-    end
-
-    def update!(document, attributes)
-      document.update!(attributes)
-      document
-    end
-
-    def destroy!(document)
-      document.destroy!
-    end
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — DocumentRepository (interface + ActiveRecord implementation)
+# Convention (ADR-05): data access is isolated here — services never call AR directly
+# This enables easy mocking in unit tests and future DB swaps
+
+module Repositories
+  class DocumentRepository
+    # ── Query ──────────────────────────────────────────────────────────────
+
+    def find(id)
+      Document.find_by(id: id)
+    end
+
+    def find!(id)
+      Document.find(id)
+    rescue ActiveRecord::RecordNotFound
+      raise ActiveRecord::RecordNotFound, "Document with id=#{id} was not found."
+    end
+
+    def all
+      Document.order(created_at: :desc)
+    end
+
+    def by_user(user_id)
+      Document.where(user_id: user_id).order(created_at: :desc)
+    end
+
+    # ── Persistence ────────────────────────────────────────────────────────
+
+    # Builds a new Document (not persisted).
+    def build(attrs = {})
+      Document.new(attrs)
+    end
+
+    # Persist (create or update). Raises ActiveRecord::RecordInvalid on failure.
+    def save!(document)
+      document.save!
+      document
+    end
+
+    # Update summary and timestamp after LLM processing.
+    def update_summary!(document, summary)
+      document.update!(summary: summary, summarized_at: Time.current)
+      document
+    end
+
+    def update!(document, attributes)
+      document.update!(attributes)
+      document
+    end
+
+    def destroy!(document)
+      document.destroy!
+    end
+  end
+end

package/templates/stacks/ruby-rails-8/app/repositories/user_repository.rb

@@ -1,73 +1,73 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — UserRepository
-# Convention (ADR-05): data access is isolated here — services never call AR directly
-# This enables easy mocking in unit tests and future DB swaps
-
-module Repositories
-  class UserRepository
-    # ── Query ──────────────────────────────────────────────────────────────
-
-    def find(id)
-      User.find_by(id: id)
-    end
-
-    def find!(id)
-      User.find(id)
-    rescue ActiveRecord::RecordNotFound
-      raise ActiveRecord::RecordNotFound, "User with id=#{id} was not found."
-    end
-
-    def find_by_email(email)
-      User.find_by(email: email.downcase.strip)
-    end
-
-    def all_active
-      User.active.order(created_at: :desc)
-    end
-
-    def paginated(page: 1, per: 25)
-      User.active
-          .order(created_at: :desc)
-          .offset((page.to_i - 1) * per.to_i)
-          .limit(per.to_i)
-    end
-
-    def count
-      User.count
-    end
-
-    # ── Persistence ────────────────────────────────────────────────────────
-
-    # Builds a new User (not persisted). Let the service validate input first.
-    def build(attributes = {})
-      User.new(attributes)
-    end
-
-    # Persist (create or update). Raises ActiveRecord::RecordInvalid on failure.
-    def save!(user)
-      user.save!
-      user
-    end
-
-    # Persist without raising. Returns false on failure.
-    def save(user)
-      user.save
-    end
-
-    def update!(user, attributes)
-      user.update!(attributes)
-      user
-    end
-
-    def destroy!(user)
-      user.destroy!
-    end
-
-    # ── Bulk ───────────────────────────────────────────────────────────────
-
-    def deactivate_all_inactive(since:)
-      User.where("last_active_at < ?", since).update_all(active: false)
-    end
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — UserRepository
+# Convention (ADR-05): data access is isolated here — services never call AR directly
+# This enables easy mocking in unit tests and future DB swaps
+
+module Repositories
+  class UserRepository
+    # ── Query ──────────────────────────────────────────────────────────────
+
+    def find(id)
+      User.find_by(id: id)
+    end
+
+    def find!(id)
+      User.find(id)
+    rescue ActiveRecord::RecordNotFound
+      raise ActiveRecord::RecordNotFound, "User with id=#{id} was not found."
+    end
+
+    def find_by_email(email)
+      User.find_by(email: email.downcase.strip)
+    end
+
+    def all_active
+      User.active.order(created_at: :desc)
+    end
+
+    def paginated(page: 1, per: 25)
+      User.active
+          .order(created_at: :desc)
+          .offset((page.to_i - 1) * per.to_i)
+          .limit(per.to_i)
+    end
+
+    def count
+      User.count
+    end
+
+    # ── Persistence ────────────────────────────────────────────────────────
+
+    # Builds a new User (not persisted). Let the service validate input first.
+    def build(attributes = {})
+      User.new(attributes)
+    end
+
+    # Persist (create or update). Raises ActiveRecord::RecordInvalid on failure.
+    def save!(user)
+      user.save!
+      user
+    end
+
+    # Persist without raising. Returns false on failure.
+    def save(user)
+      user.save
+    end
+
+    def update!(user, attributes)
+      user.update!(attributes)
+      user
+    end
+
+    def destroy!(user)
+      user.destroy!
+    end
+
+    # ── Bulk ───────────────────────────────────────────────────────────────
+
+    def deactivate_all_inactive(since:)
+      User.where("last_active_at < ?", since).update_all(active: false)
+    end
+  end
+end

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

@@ -1,67 +1,67 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — CreateUserService
-# Convention (ADR-01): one service per operation; injected dependencies for testability
-#
-# Usage:
-#   result = Services::CreateUserService.new(
-#     user_repository: Repositories::UserRepository.new,
-#     event_publisher: RealtimeService.instance
-#   ).execute(email: "user@example.com", name: "Alice")
-#
-# Returns: User (persisted)
-# Raises:  Services::CreateUserService::EmailTakenError
-#          ActiveRecord::RecordInvalid (validation failure)
-
-module Services
-  class CreateUserService
-    # ── Domain errors ──────────────────────────────────────────────────────
-    class EmailTakenError < StandardError
-      def initialize(email)
-        super("Email '#{email}' is already registered.")
-      end
-    end
-
-    # ── Constructor ────────────────────────────────────────────────────────
-    def initialize(user_repository:, event_publisher:)
-      @user_repository = user_repository
-      @event_publisher = event_publisher
-    end
-
-    # ── Main operation ─────────────────────────────────────────────────────
-    def execute(email:, name:, password: nil, **extra_attrs)
-      email = email.to_s.downcase.strip
-
-      # Guard: check for duplicate email
-      if @user_repository.find_by_email(email)
-        raise EmailTakenError, email
-      end
-
-      # Build and persist
-      user = @user_repository.build(
-        email:      email,
-        name:       name.to_s.strip,
-        active:     true,
-        **extra_attrs
-      )
-
-      # Hash password if provided (example using has_secure_password)
-      user.password = password if password.present?
-
-      @user_repository.save!(user)
-
-      # Publish real-time event
-      @event_publisher.publish(
-        type: "user.created",
-        data: {
-          user_id: user.id,
-          email:   user.email,
-          name:    user.name,
-          timestamp: Time.now.to_i
-        }
-      )
-
-      user
-    end
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — CreateUserService
+# Convention (ADR-01): one service per operation; injected dependencies for testability
+#
+# Usage:
+#   result = Services::CreateUserService.new(
+#     user_repository: Repositories::UserRepository.new,
+#     event_publisher: RealtimeService.instance
+#   ).execute(email: "user@example.com", name: "Alice")
+#
+# Returns: User (persisted)
+# Raises:  Services::CreateUserService::EmailTakenError
+#          ActiveRecord::RecordInvalid (validation failure)
+
+module Services
+  class CreateUserService
+    # ── Domain errors ──────────────────────────────────────────────────────
+    class EmailTakenError < StandardError
+      def initialize(email)
+        super("Email '#{email}' is already registered.")
+      end
+    end
+
+    # ── Constructor ────────────────────────────────────────────────────────
+    def initialize(user_repository:, event_publisher:)
+      @user_repository = user_repository
+      @event_publisher = event_publisher
+    end
+
+    # ── Main operation ─────────────────────────────────────────────────────
+    def execute(email:, name:, password: nil, **extra_attrs)
+      email = email.to_s.downcase.strip
+
+      # Guard: check for duplicate email
+      if @user_repository.find_by_email(email)
+        raise EmailTakenError, email
+      end
+
+      # Build and persist
+      user = @user_repository.build(
+        email:      email,
+        name:       name.to_s.strip,
+        active:     true,
+        **extra_attrs
+      )
+
+      # Hash password if provided (example using has_secure_password)
+      user.password = password if password.present?
+
+      @user_repository.save!(user)
+
+      # Publish real-time event
+      @event_publisher.publish(
+        type: "user.created",
+        data: {
+          user_id: user.id,
+          email:   user.email,
+          name:    user.name,
+          timestamp: Time.now.to_i
+        }
+      )
+
+      user
+    end
+  end
+end

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

@@ -1,53 +1,53 @@
-# frozen_string_literal: true
-
-# DARE v3.0 — RealtimeService
-# Convention (ADR-03): centralized broadcaster — services call this, not channels directly
-# Singleton via .instance; injectable in tests via double
-#
-# Usage in a Service:
-#   RealtimeService.instance.publish(
-#     type: "user.created",
-#     data: { user_id: 42, email: "user@example.com" }
-#   )
-#
-# Frontend receives:
-#   { type: "user.created", data: { ... }, timestamp: 1234567890 }
-
-class RealtimeService
-  include Singleton
-
-  # ── Public API ────────────────────────────────────────────────────────────
-
-  # Broadcast to all subscribers of a channel stream.
-  # channel_class: e.g. UserUpdatesChannel
-  # target:        e.g. user.id  (matched against stream_for in the channel)
-  # payload:       Hash with :type and :data
-  def broadcast_to(channel_class, target, type:, data: {})
-    event = build_event(type: type, data: data)
-    channel_class.broadcast_to(target, event)
-  end
-
-  # Generic publish: broadcasts to `dare_updates:<user_id>` for all active users.
-  # Use for system-wide events.
-  def publish(type:, data: {}, user_id: nil)
-    event   = build_event(type: type, data: data)
-    stream  = user_id ? "dare_updates:#{user_id}" : "dare_updates:global"
-    ActionCable.server.broadcast(stream, event)
-  end
-
-  # Publish to a named stream directly (lower-level).
-  def broadcast_to_stream(stream_name, type:, data: {})
-    event = build_event(type: type, data: data)
-    ActionCable.server.broadcast(stream_name, event)
-  end
-
-  private
-
-  def build_event(type:, data: {})
-    {
-      type:      type,
-      data:      data,
-      timestamp: Time.now.to_i
-    }
-  end
-end
+# frozen_string_literal: true
+
+# DARE v3.0 — RealtimeService
+# Convention (ADR-03): centralized broadcaster — services call this, not channels directly
+# Singleton via .instance; injectable in tests via double
+#
+# Usage in a Service:
+#   RealtimeService.instance.publish(
+#     type: "user.created",
+#     data: { user_id: 42, email: "user@example.com" }
+#   )
+#
+# Frontend receives:
+#   { type: "user.created", data: { ... }, timestamp: 1234567890 }
+
+class RealtimeService
+  include Singleton
+
+  # ── Public API ────────────────────────────────────────────────────────────
+
+  # Broadcast to all subscribers of a channel stream.
+  # channel_class: e.g. UserUpdatesChannel
+  # target:        e.g. user.id  (matched against stream_for in the channel)
+  # payload:       Hash with :type and :data
+  def broadcast_to(channel_class, target, type:, data: {})
+    event = build_event(type: type, data: data)
+    channel_class.broadcast_to(target, event)
+  end
+
+  # Generic publish: broadcasts to `dare_updates:<user_id>` for all active users.
+  # Use for system-wide events.
+  def publish(type:, data: {}, user_id: nil)
+    event   = build_event(type: type, data: data)
+    stream  = user_id ? "dare_updates:#{user_id}" : "dare_updates:global"
+    ActionCable.server.broadcast(stream, event)
+  end
+
+  # Publish to a named stream directly (lower-level).
+  def broadcast_to_stream(stream_name, type:, data: {})
+    event = build_event(type: type, data: data)
+    ActionCable.server.broadcast(stream_name, event)
+  end
+
+  private
+
+  def build_event(type:, data: {})
+    {
+      type:      type,
+      data:      data,
+      timestamp: Time.now.to_i
+    }
+  end
+end