agentcode 0.9.0

data/lib/agentcode/tasks/agentcode.rake

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+namespace :agentcode do
+  desc "Install and configure AgentCode for your Rails application"
+  task install: :environment do
+    require "agentcode/commands/install_command"
+    AgentCode::Commands::InstallCommand.new.perform
+  end
+
+  desc "Generate AgentCode resources (Model, Policy, Scope)"
+  task generate: :environment do
+    require "agentcode/commands/generate_command"
+    AgentCode::Commands::GenerateCommand.new.perform
+  end
+
+  desc "Generate code from YAML blueprint files"
+  task blueprint: :environment do
+    require "agentcode/commands/blueprint_command"
+    AgentCode::Commands::BlueprintCommand.new.perform
+  end
+
+  desc "Export Postman collection for all registered models"
+  task export_postman: :environment do
+    require "agentcode/commands/export_postman_command"
+    cmd = AgentCode::Commands::ExportPostmanCommand.new
+    cmd.perform
+  end
+end
+
+namespace :invitation do
+  desc "Generate an invitation link for testing"
+  task :link, [:email, :organization] => :environment do |_t, args|
+    require "agentcode/commands/invitation_link_command"
+    cmd = AgentCode::Commands::InvitationLinkCommand.new
+    cmd.email = args[:email]
+    cmd.organization_identifier = args[:organization]
+    cmd.perform
+  end
+end

data/lib/agentcode/templates/agentcode.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# AgentCode Configuration
+# This file is used to configure AgentCode for your Rails application.
+# See: https://github.com/startsoft/agentcode
+
+AgentCode.configure do |config|
+  # ---------------------------------------------------------------
+  # Models
+  # ---------------------------------------------------------------
+  # Register your models here. Each model gets automatic CRUD endpoints.
+  #
+  # config.model :posts, 'Post'
+  # config.model :comments, 'Comment'
+  # config.model :users, 'User'
+
+  # ---------------------------------------------------------------
+  # Route Groups (required)
+  # ---------------------------------------------------------------
+  # Define how models are exposed via different URL prefixes.
+  # Each group can have its own prefix, middleware, and model list.
+  #
+  # Reserved group names:
+  #   :tenant  — enables organization scoping (invitations + nested registered here)
+  #   :public  — skips authentication for routes in this group
+  #
+  # Models can be :all (all registered models) or an array of slugs.
+  #
+  # Simple non-tenant app:
+  # config.route_group :default, prefix: '', middleware: [], models: :all
+  #
+  # Simple multi-tenant app:
+  # config.route_group :tenant, prefix: ':organization', middleware: [AgentCode::Middleware::ResolveOrganizationFromRoute], models: :all
+  #
+  # Hybrid platform (customer + driver + admin + public):
+  # config.route_group :tenant, prefix: ':organization', middleware: [AgentCode::Middleware::ResolveOrganizationFromRoute], models: :all
+  # config.route_group :driver, prefix: 'driver', middleware: [], models: [:trips, :trucks]
+  # config.route_group :admin, prefix: 'admin', middleware: [], models: :all
+  # config.route_group :public, prefix: 'public', middleware: [], models: [:materials]
+
+  # config.route_group :default, prefix: '', middleware: [], models: :all
+
+  # ---------------------------------------------------------------
+  # Multi-tenant
+  # ---------------------------------------------------------------
+  # config.multi_tenant = {
+  #   organization_identifier_column: 'id'  # Options: 'id', 'slug', or any column
+  # }
+
+  # ---------------------------------------------------------------
+  # Invitations
+  # ---------------------------------------------------------------
+  # config.invitations = {
+  #   expires_days: 7,
+  #   allowed_roles: nil  # nil means all roles can invite
+  # }
+
+  # ---------------------------------------------------------------
+  # Nested Operations
+  # ---------------------------------------------------------------
+  # config.nested = {
+  #   path: 'nested',
+  #   max_operations: 50,
+  #   allowed_models: nil  # nil = all registered models
+  # }
+
+  # ---------------------------------------------------------------
+  # Test Framework
+  # ---------------------------------------------------------------
+  # config.test_framework = 'rspec'  # Options: 'rspec', 'minitest'
+end

data/lib/agentcode/templates/agentcode_model.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+# Application-level AgentCodeModel base class.
+#
+# This file was published from the agentcode gem. You can customise it
+# to add concerns or configuration that apply to ALL your AgentCode models.
+#
+# Published with:  rails agentcode:install --publish-model
+#
+# To use:
+#   class Post < AgentCodeModel
+#     # ...
+#   end
+#
+# The parent class already includes:
+#   - AgentCode::HasAgentCode, AgentCode::HasValidation,
+#     AgentCode::HidableColumns, AgentCode::HasAutoScope
+#
+# Add your own concerns or override defaults below.
+class AgentCodeModel < AgentCode::AgentCodeModel
+  self.abstract_class = true
+
+  #
+  # Add application-wide concerns here. For example:
+  #
+  # include AgentCode::HasAuditTrail
+  # include AgentCode::HasUuid
+  # include AgentCode::BelongsToOrganization
+
+  # -----------------------------------------------------------------
+  # Validation
+  # -----------------------------------------------------------------
+  #
+  # Use standard ActiveModel validations for type/format constraints.
+  # All validators should use `allow_nil: true` — presence is controlled
+  # by store/update rules below.
+  #
+  # validates :title, length: { maximum: 255 }, allow_nil: true
+  # validates :content, length: { maximum: 10_000 }, allow_nil: true
+  # validates :status, inclusion: { in: %w[draft published archived] }, allow_nil: true
+  #
+  # -----------------------------------------------------------------
+  # Store / Update rules (field allowlist + presence modifiers)
+  # -----------------------------------------------------------------
+  #
+  # Field permissions (which fields each role can create/update) are
+  # controlled by the policy, not the model. See:
+  #   app/policies/<model_name>_policy.rb
+  #
+  # Example policy methods:
+  #   def permitted_attributes_for_create(user)
+  #     has_role?(user, 'admin') ? ['*'] : ['title', 'content']
+  #   end
+  #   def permitted_attributes_for_update(user)
+  #     has_role?(user, 'admin') ? ['*'] : ['title', 'content']
+  #   end
+
+  # -----------------------------------------------------------------
+  # Query Builder — Filtering, Sorting, Search, Includes, Fields
+  # -----------------------------------------------------------------
+  #
+  # agentcode_filters :status, :user_id, :category_id
+  # agentcode_sorts   :created_at, :title, :updated_at
+  # self.default_sort_field = '-created_at'
+  # agentcode_fields  :id, :title, :status, :created_at
+  # agentcode_includes :user, :comments, :tags
+  # agentcode_search  :title, :content, :excerpt
+
+  # -----------------------------------------------------------------
+  # Pagination
+  # -----------------------------------------------------------------
+  #
+  # self.pagination_enabled = true
+  # self.agentcode_per_page_count = 25
+
+  # -----------------------------------------------------------------
+  # Middleware
+  # -----------------------------------------------------------------
+  #
+  # self.agentcode_model_middleware = ['throttle:60,1']
+  #
+  # self.agentcode_middleware_actions_map = {
+  #   'store'   => ['verified'],
+  #   'update'  => ['verified'],
+  #   'destroy' => ['admin'],
+  # }
+
+  # -----------------------------------------------------------------
+  # Route Exclusion
+  # -----------------------------------------------------------------
+  #
+  # # Disable delete endpoints entirely:
+  # self.agentcode_except_actions_list = ['destroy', 'force_delete']
+  #
+  # # Read-only API:
+  # self.agentcode_except_actions_list = ['store', 'update', 'destroy']
+
+  # -----------------------------------------------------------------
+  # Hidden Columns
+  # -----------------------------------------------------------------
+  #
+  # self.additional_hidden_columns = ['api_token', 'stripe_id', 'internal_notes']
+
+end

data/lib/agentcode/templates/audit_trail/create_audit_logs.rb.erb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+class CreateAuditLogs < ActiveRecord::Migration[8.0]
+  def change
+    create_table :audit_logs do |t|
+      t.string :auditable_type, null: false
+      t.bigint :auditable_id, null: false
+      t.string :action, null: false
+      t.json :old_values
+      t.json :new_values
+      t.bigint :user_id
+      t.string :user_type
+      t.string :ip_address
+      t.string :user_agent
+      t.bigint :organization_id
+
+      t.timestamps
+    end
+
+    add_index :audit_logs, [:auditable_type, :auditable_id]
+    add_index :audit_logs, :user_id
+    add_index :audit_logs, :organization_id
+    add_index :audit_logs, :action
+    add_index :audit_logs, :created_at
+  end
+end

data/lib/agentcode/templates/generate/factory.rb.erb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :<%= name.underscore %> do
+<% columns.each do |col| -%>
+<% if col[:type] == "references" && col[:foreign_model] -%>
+    association :<%= col[:name].sub(/_id\z/, "") %>
+<% elsif col[:name] =~ /\Aname\z|\Afull_name\z/ -%>
+    <%= col[:name] %> { Faker::Name.name }
+<% elsif col[:name] == "email" -%>
+    email { Faker::Internet.email }
+<% elsif col[:name] == "title" -%>
+    title { Faker::Lorem.sentence(word_count: 3) }
+<% elsif col[:name] =~ /\Adescription\z|\Acontent\z|\Abody\z/ -%>
+    <%= col[:name] %> { Faker::Lorem.paragraph }
+<% elsif col[:name] == "slug" -%>
+    slug { Faker::Internet.slug }
+<% elsif col[:name] =~ /\Ais_/ -%>
+    <%= col[:name] %> { [true, false].sample }
+<% elsif col[:type] == "string" -%>
+    <%= col[:name] %> { Faker::Lorem.sentence(word_count: 3) }
+<% elsif col[:type] == "text" -%>
+    <%= col[:name] %> { Faker::Lorem.paragraph }
+<% elsif col[:type] =~ /\Ainteger\z|\Abigint\z/ -%>
+    <%= col[:name] %> { Faker::Number.between(from: 1, to: 100) }
+<% elsif col[:type] == "boolean" -%>
+    <%= col[:name] %> { [true, false].sample }
+<% elsif col[:type] == "date" -%>
+    <%= col[:name] %> { Faker::Date.between(from: 1.year.ago, to: Date.today) }
+<% elsif col[:type] == "datetime" -%>
+    <%= col[:name] %> { Faker::Time.between(from: 1.year.ago, to: Time.current) }
+<% elsif col[:type] =~ /\Adecimal\z|\Afloat\z/ -%>
+    <%= col[:name] %> { Faker::Number.decimal(l_digits: 3, r_digits: 2) }
+<% elsif col[:type] == "json" -%>
+    <%= col[:name] %> { {} }
+<% elsif col[:type] == "uuid" -%>
+    <%= col[:name] %> { SecureRandom.uuid }
+<% else -%>
+    <%= col[:name] %> { Faker::Lorem.word }
+<% end -%>
+<% end -%>
+  end
+end

data/lib/agentcode/templates/generate/migration.rb.erb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+class <%= class_name %> < ActiveRecord::Migration[8.0]
+  def change
+    create_table :<%= table_name %> do |t|
+<% columns.each do |col| -%>
+<% if col[:type] == "references" -%>
+      t.references :<%= col[:name].sub(/_id\z/, "") %>, null: <%= col[:nullable] %>, foreign_key: true<%= col[:index] ? ", index: true" : "" %>
+<% elsif col[:type] == "decimal" -%>
+      t.decimal :<%= col[:name] %>, precision: 8, scale: 2<%= col[:nullable] ? ", null: true" : "" %><%= col[:unique] ? ", unique: true" : "" %><%= col[:default] ? ", default: #{col[:default]}" : "" %>
+<% else -%>
+      t.<%= col[:type] %> :<%= col[:name] %><%= col[:nullable] ? ", null: true" : "" %><%= col[:unique] ? ", unique: true" : "" %><%= col[:default] ? ", default: #{col[:default].inspect}" : "" %>
+<% end -%>
+<% end -%>
+<% if soft_deletes -%>
+      t.datetime :discarded_at
+<% end -%>
+
+      t.timestamps
+    end
+<% if soft_deletes -%>
+
+    add_index :<%= table_name %>, :discarded_at
+<% end -%>
+  end
+end

data/lib/agentcode/templates/generate/model.rb.erb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+class <%= name %> < AgentCode::AgentCodeModel
+<% if belongs_to_org -%>
+  include AgentCode::BelongsToOrganization
+<% end -%>
+<% if soft_deletes -%>
+  include Discard::Model
+<% end -%>
+<% if audit_trail -%>
+  include AgentCode::HasAuditTrail
+<% end -%>
+
+  # ---------------------------------------------------------------
+  # Query Builder configuration
+  # ---------------------------------------------------------------
+
+<% unless filter_cols.empty? -%>
+  agentcode_filters <%= filter_cols.map { |c| ":#{c}" }.join(", ") %>
+<% end -%>
+<% unless sort_cols.empty? -%>
+  agentcode_sorts <%= sort_cols.map { |c| ":#{c}" }.join(", ") %>
+<% end -%>
+<% unless field_cols.empty? -%>
+  agentcode_fields <%= field_cols.map { |c| ":#{c}" }.join(", ") %>
+<% end -%>
+<% unless include_cols.empty? -%>
+  agentcode_includes <%= include_cols.map { |c| ":#{c}" }.join(", ") %>
+<% end -%>
+
+  # ---------------------------------------------------------------
+  # Validation (ActiveModel — use allow_nil: true for all validators)
+  # ---------------------------------------------------------------
+
+<% validation_rules.each do |field, validations| -%>
+<% next if validations.empty? -%>
+  validates :<%= field %>, <%= validations.join(", ") %>, allow_nil: true
+<% end -%>
+
+  # ---------------------------------------------------------------
+  # Field permissions are controlled by the policy.
+  # See: app/policies/<%= name.underscore %>_policy.rb
+  # ---------------------------------------------------------------
+
+  # ---------------------------------------------------------------
+  # Relationships
+  # (Organization scoping is auto-detected from belongs_to associations)
+  # ---------------------------------------------------------------
+
+<% columns.select { |c| c[:type] == "references" && c[:foreign_model] }.each do |col| -%>
+<% relation_name = col[:name].sub(/_id\z/, "") -%>
+<% next if belongs_to_org && col[:foreign_model] == "Organization" -%>
+  belongs_to :<%= relation_name %>, class_name: "<%= col[:foreign_model] %>"
+<% end -%>
+end

data/lib/agentcode/templates/generate/policy.rb.erb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+class <%= name %>Policy < AgentCode::ResourcePolicy
+  # Override any method for custom authorization logic.
+  # Call super to compose with the default permission check.
+  #
+  # Example:
+  #   def update?(user, record)
+  #     super && record.user_id == user.id
+  #   end
+
+  # def index?
+  #   super
+  # end
+
+  # def show?
+  #   super
+  # end
+
+  # def create?
+  #   super
+  # end
+
+  # def update?
+  #   super
+  # end
+
+  # def destroy?
+  #   super
+  # end
+
+  # ---------------------------------------------------------------
+  # Attribute Permissions
+  # ---------------------------------------------------------------
+  # Override to control which fields each role can read/write.
+  #
+  # def permitted_attributes_for_show(user)
+  #   has_role?(user, 'admin') ? ['*'] : ['id', 'title']
+  # end
+  #
+  # def hidden_attributes_for_show(user)
+  #   has_role?(user, 'admin') ? [] : ['internal_notes']
+  # end
+  #
+  # def permitted_attributes_for_create(user)
+  #   has_role?(user, 'admin') ? ['*'] : ['title', 'content']
+  # end
+  #
+  # def permitted_attributes_for_update(user)
+  #   has_role?(user, 'admin') ? ['*'] : ['title', 'content']
+  # end
+end

data/lib/agentcode/templates/generate/scope.rb.erb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Scopes
+  class <%= name %>Scope < AgentCode::ResourceScope
+    # Custom query scope for <%= name %>.
+    # Applied automatically to all <%= name %> queries via HasAutoScope.
+    #
+    # Available methods:
+    #   - user          — the current authenticated user (or nil)
+    #   - organization  — the current organization (or nil)
+    #   - role          — the user's role slug in the current org (or nil)
+    #
+    # @param relation [ActiveRecord::Relation] the current query scope
+    # @return [ActiveRecord::Relation] the modified scope
+    def apply(relation)
+      # Uncomment and customize your filter logic:
+      #
+      # Example: role-based filtering
+      # if role == "viewer"
+      #   relation = relation.where(status: "active")
+      # end
+      #
+      # Example: user-scoped records
+      # if user
+      #   relation = relation.where(user_id: user.id)
+      # end
+
+      relation
+    end
+  end
+end

data/lib/agentcode/templates/multi_tenant/factories/organizations.rb.erb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :organization do
+    name { Faker::Company.name }
+    slug { Faker::Internet.slug }
+    description { Faker::Lorem.sentence }
+  end
+end

data/lib/agentcode/templates/multi_tenant/factories/roles.rb.erb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :role do
+    name { Faker::Job.title }
+    slug { Faker::Internet.slug }
+    description { Faker::Lorem.sentence }
+  end
+end

data/lib/agentcode/templates/multi_tenant/factories/user_roles.rb.erb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :user_role do
+    association :user
+    association :organization
+    association :role
+    permissions { [] }
+  end
+end

data/lib/agentcode/templates/multi_tenant/factories/users.rb.erb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :user do
+    name { Faker::Name.name }
+    email { Faker::Internet.email }
+    password { "password123" }
+  end
+end

data/lib/agentcode/templates/multi_tenant/migrations/create_organizations.rb.erb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class CreateOrganizations < ActiveRecord::Migration[8.0]
+  def change
+    create_table :organizations do |t|
+      t.string :name, null: false
+      t.string :slug, null: false
+      t.text :description
+
+      t.timestamps
+    end
+
+    add_index :organizations, :slug, unique: true
+  end
+end

data/lib/agentcode/templates/multi_tenant/migrations/create_roles.rb.erb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class CreateRoles < ActiveRecord::Migration[8.0]
+  def change
+    create_table :roles do |t|
+      t.string :name, null: false
+      t.string :slug, null: false
+      t.text :description
+
+      t.timestamps
+    end
+
+    add_index :roles, :slug, unique: true
+  end
+end

data/lib/agentcode/templates/multi_tenant/migrations/create_user_roles.rb.erb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+class CreateUserRoles < ActiveRecord::Migration[8.0]
+  def change
+    create_table :user_roles do |t|
+      t.references :user, null: false, foreign_key: true
+      t.references :organization, null: false, foreign_key: true
+      t.references :role, null: false, foreign_key: true
+      t.json :permissions, default: []
+
+      t.timestamps
+    end
+
+    add_index :user_roles, [:user_id, :organization_id], unique: true
+  end
+end

data/lib/agentcode/templates/multi_tenant/migrations/create_users.rb.erb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class CreateUsers < ActiveRecord::Migration[8.0]
+  def change
+    create_table :users do |t|
+      t.string :name, null: false
+      t.string :email, null: false
+      t.string :password_digest, null: false
+
+      t.timestamps
+    end
+
+    add_index :users, :email, unique: true
+  end
+end

data/lib/agentcode/templates/multi_tenant/models/organization.rb.erb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+class Organization < ApplicationRecord
+  has_many :user_roles, dependent: :destroy
+  has_many :users, through: :user_roles
+  has_many :roles, through: :user_roles
+
+  validates :name, presence: true
+  validates :slug, presence: true, uniqueness: true
+
+  before_validation :generate_slug, on: :create
+
+  private
+
+  def generate_slug
+    self.slug ||= name&.parameterize
+  end
+end

data/lib/agentcode/templates/multi_tenant/models/role.rb.erb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+class Role < ApplicationRecord
+  ROLES = <%= roles.inspect %>.freeze
+
+  has_many :user_roles, dependent: :destroy
+  has_many :users, through: :user_roles
+
+  validates :name, presence: true
+  validates :slug, presence: true, uniqueness: true
+end

data/lib/agentcode/templates/multi_tenant/models/user.rb.erb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+class User < ApplicationRecord
+  include AgentCode::HasPermissions
+
+  has_secure_password
+
+  has_many :user_roles, dependent: :destroy
+  has_many :organizations, through: :user_roles
+  has_many :roles, through: :user_roles
+
+  validates :name, presence: true
+  validates :email, presence: true, uniqueness: true
+end

data/lib/agentcode/templates/multi_tenant/models/user_role.rb.erb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+class UserRole < ApplicationRecord
+  belongs_to :user
+  belongs_to :organization
+  belongs_to :role
+
+  validates :user_id, uniqueness: { scope: :organization_id }
+end

data/lib/agentcode/templates/multi_tenant/policies/organization_policy.rb.erb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+class OrganizationPolicy < AgentCode::ResourcePolicy
+  # Organizations are managed by admins only.
+  # Override methods as needed.
+end

data/lib/agentcode/templates/multi_tenant/policies/role_policy.rb.erb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+class RolePolicy < AgentCode::ResourcePolicy
+  # Roles are managed by admins only.
+  # Override methods as needed.
+end

data/lib/agentcode/templates/multi_tenant/seeders/organization_seeder.rb.erb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# Seed a default organization
+org = Organization.find_or_create_by!(slug: "default") do |o|
+  o.name = "Default Organization"
+  o.description = "Default organization created during setup"
+end
+
+puts "Organization seeded: #{org.name} (#{org.slug})"

data/lib/agentcode/templates/multi_tenant/seeders/role_seeder.rb.erb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Seed roles for multi-tenant setup
+<% roles.each do |role| -%>
+<% role_name = role.capitalize -%>
+<% description = case role
+   when "admin" then "Administrator role with full access"
+   when "editor" then "Editor role with create, read, and update access"
+   when "viewer" then "Viewer role with read-only access"
+   when "writer" then "Writer role with create and edit access"
+   else "#{role_name} role"
+   end -%>
+Role.find_or_create_by!(slug: "<%= role %>") do |r|
+  r.name = "<%= role_name %>"
+  r.description = "<%= description %>"
+end
+<% end -%>
+
+puts "Roles seeded: <%= roles.join(', ') %>"