open-loam 0.1.1 → 0.2.0

data/lib/generators/loam/install/templates/migrations/create_loam_custom_field_values.rb

@@ -1,19 +0,0 @@
-class CreateLoamCustomFieldValues < ActiveRecord::Migration[<%= ActiveRecord::VERSION::STRING.to_f %>]
-  def change
-    create_table :loam_custom_field_values<%= loam_id_option %> do |t|
-      t.references :tenant, null: false, foreign_key: { to_table: :loam_tenants }<%= loam_type_option %>
-      t.string :indexable_type, null: false
-      t.<%= loam_key_column_type %> :indexable_id<%= loam_key_limit_option %>, null: false
-      t.string :field_key, null: false
-      t.text :value_text                # canonical string form (contains/present/eq)
-      t.decimal :value_number           # integer/decimal fields (range queries)
-      t.boolean :value_boolean          # boolean fields
-      t.datetime :value_datetime        # date/datetime fields
-      t.timestamps
-    end
-    add_index :loam_custom_field_values, %i[indexable_type indexable_id field_key],
-              unique: true, name: "index_loam_cfv_unique"
-    add_index :loam_custom_field_values, %i[tenant_id indexable_type field_key value_text], name: "index_loam_cfv_text"
-    add_index :loam_custom_field_values, %i[tenant_id indexable_type field_key value_number], name: "index_loam_cfv_number"
-  end
-end

data/lib/generators/loam/install/templates/migrations/create_loam_dashboard_widgets.rb

@@ -1,12 +0,0 @@
-class CreateLoamDashboardWidgets < ActiveRecord::Migration[<%= ActiveRecord::VERSION::STRING.to_f %>]
-  def change
-    create_table :loam_dashboard_widgets<%= loam_id_option %> do |t|
-      t.references :tenant, null: false, foreign_key: { to_table: :loam_tenants }<%= loam_type_option %>
-      t.string :widget_key, null: false   # a registered Loam::Widgets key
-      t.integer :position, null: false, default: 0
-      t.boolean :active, null: false, default: true
-      t.timestamps
-    end
-    add_index :loam_dashboard_widgets, %i[tenant_id widget_key], unique: true
-  end
-end

data/lib/generators/loam/install/templates/migrations/create_loam_dictionaries.rb

@@ -1,11 +0,0 @@
-class CreateLoamDictionaries < ActiveRecord::Migration[<%= ActiveRecord::VERSION::STRING.to_f %>]
-  def change
-    create_table :loam_dictionaries<%= loam_id_option %> do |t|
-      t.references :tenant, null: false, foreign_key: { to_table: :loam_tenants }<%= loam_type_option %>
-      t.string :key, null: false   # the code the field def / API references (e.g. "damage_severity")
-      t.string :name, null: false  # human label for the list
-      t.timestamps
-    end
-    add_index :loam_dictionaries, %i[tenant_id key], unique: true
-  end
-end

data/lib/generators/loam/install/templates/migrations/create_loam_memberships.rb

@@ -1,11 +0,0 @@
-class CreateLoamMemberships < ActiveRecord::Migration[<%= ActiveRecord::VERSION::STRING.to_f %>]
-  def change
-    create_table :loam_memberships<%= loam_id_option %> do |t|
-      t.references :tenant, null: false, foreign_key: { to_table: :loam_tenants }<%= loam_type_option %>
-      t.references :user, null: false, foreign_key: true<%= loam_type_option %>
-      t.string :role, null: false
-      t.timestamps
-    end
-    add_index :loam_memberships, %i[tenant_id user_id], unique: true
-  end
-end

data/lib/generators/loam/install/templates/migrations/create_loam_notifications.rb

@@ -1,15 +0,0 @@
-class CreateLoamNotifications < ActiveRecord::Migration[<%= ActiveRecord::VERSION::STRING.to_f %>]
-  def change
-    create_table :loam_notifications<%= loam_id_option %> do |t|
-      t.references :tenant, null: false, foreign_key: { to_table: :loam_tenants }<%= loam_type_option %>
-      t.references :user, null: false, foreign_key: true<%= loam_type_option %>
-      t.string :title, null: false
-      t.text :body
-      t.datetime :read_at
-      t.string :source_type
-      t.<%= loam_key_column_type %> :source_id<%= loam_key_limit_option %>
-      t.timestamps
-    end
-    add_index :loam_notifications, %i[tenant_id user_id read_at]
-  end
-end

data/lib/generators/loam/install/templates/migrations/create_loam_record_locks.rb

@@ -1,16 +0,0 @@
-class CreateLoamRecordLocks < ActiveRecord::Migration[<%= ActiveRecord::VERSION::STRING.to_f %>]
-  def change
-    create_table :loam_record_locks<%= loam_id_option %> do |t|
-      t.references :tenant, null: false, foreign_key: { to_table: :loam_tenants }<%= loam_type_option %>
-      t.string :lockable_type, null: false
-      t.<%= loam_key_column_type %> :lockable_id<%= loam_key_limit_option %>, null: false
-      t.references :locked_by, null: false, foreign_key: { to_table: :users }<%= loam_type_option %>
-      t.string :token, null: false
-      t.datetime :expires_at, null: false   # TTL; an expired lock is treated as free
-      t.timestamps                          # updated_at is the heartbeat
-    end
-    # One advisory lock per record.
-    add_index :loam_record_locks, %i[tenant_id lockable_type lockable_id], unique: true,
-              name: "index_loam_record_locks_on_lockable"
-  end
-end

data/lib/generators/loam/install/templates/migrations/create_loam_search_tokens.rb

@@ -1,18 +0,0 @@
-class CreateLoamSearchTokens < ActiveRecord::Migration[<%= ActiveRecord::VERSION::STRING.to_f %>]
-  def change
-    create_table :loam_search_tokens<%= loam_id_option %> do |t|
-      t.references :tenant, null: false, foreign_key: { to_table: :loam_tenants }<%= loam_type_option %>
-      t.string :searchable_type, null: false  # the entity class name (e.g. "Gadget")
-      t.<%= loam_key_column_type %> :searchable_id<%= loam_key_limit_option %>, null: false     # the record it indexes
-      t.string :token, null: false             # one normalized word
-    end
-    # The match subquery filters by (tenant, type, token); index maintenance
-    # deletes by (tenant, type, record). One index each — no timestamps: these
-    # are plumbing rows written with insert_all/delete_all.
-    #
-    # Shipped even though the default LikeDriver never uses it, so switching to
-    # Loam::Search::TokenDriver is a one-line initializer change, not a migration.
-    add_index :loam_search_tokens, %i[tenant_id searchable_type token]
-    add_index :loam_search_tokens, %i[tenant_id searchable_type searchable_id]
-  end
-end

data/lib/generators/loam/install/templates/migrations/create_loam_tenants.rb

@@ -1,9 +0,0 @@
-class CreateLoamTenants < ActiveRecord::Migration[<%= ActiveRecord::VERSION::STRING.to_f %>]
-  def change
-    create_table :loam_tenants<%= loam_id_option %> do |t|
-      t.string :name, null: false
-      t.string :slug, null: false, index: { unique: true }
-      t.timestamps
-    end
-  end
-end

data/lib/generators/loam/install/templates/migrations/create_loam_translations.rb

@@ -1,15 +0,0 @@
-class CreateLoamTranslations < ActiveRecord::Migration[<%= ActiveRecord::VERSION::STRING.to_f %>]
-  def change
-    create_table :loam_translations<%= loam_id_option %> do |t|
-      t.references :tenant, null: false, foreign_key: { to_table: :loam_tenants }<%= loam_type_option %>
-      t.string :translatable_type, null: false
-      t.<%= loam_key_column_type %> :translatable_id<%= loam_key_limit_option %>, null: false
-      t.string :locale, null: false            # "en", "de", "pl"
-      t.string :field, null: false             # the translated attribute
-      t.text :value                            # the per-locale content
-      t.timestamps
-    end
-    add_index :loam_translations, %i[translatable_type translatable_id locale field],
-              unique: true, name: "index_loam_translations_unique"
-  end
-end

data/lib/generators/loam/install/templates/migrations/create_loam_webhook_endpoints.rb

@@ -1,13 +0,0 @@
-class CreateLoamWebhookEndpoints < ActiveRecord::Migration[<%= ActiveRecord::VERSION::STRING.to_f %>]
-  def change
-    create_table :loam_webhook_endpoints<%= loam_id_option %> do |t|
-      t.references :tenant, null: false, foreign_key: { to_table: :loam_tenants }<%= loam_type_option %>
-      t.string :url, null: false
-      t.string :event_pattern, null: false
-      t.string :secret, null: false
-      t.boolean :active, null: false, default: true
-      t.timestamps
-    end
-    add_index :loam_webhook_endpoints, %i[tenant_id active]
-  end
-end

data/lib/loam/engine.rb

@@ -1,57 +0,0 @@
-module Loam
-  class Engine < ::Rails::Engine
-    # Not isolated on purpose: Loam models live under the Loam:: namespace but
-    # share the host app's routes/helpers, keeping the prototype surface small.
-
-    # Webhook dispatch listens to every Loam event. Wired after initialization
-    # so the models it queries are loadable, and guarded against subscribing
-    # twice (see Loam::Webhooks.subscribe!).
-    config.after_initialize do
-      Loam::Webhooks.subscribe!
-      Loam::DurableEvents.subscribe!    # persist + retry durable subscribers (L-706)
-      Loam::BusinessRules.subscribe!
-      Loam::Widgets.register_builtins!  # the default dashboard widgets
-      Loam::Overrides.check!            # warn about any stale disable/replace overrides
-
-      # The durability sweep runs per-tenant on a schedule (materialized into
-      # each tenant by Loam::Scheduler.sync_tenant). interval:300 = every 5 min.
-      Loam::Scheduler.register(
-        key: Loam::DurableEvents::SWEEP_KEY, name: "Event redelivery sweep",
-        job_class: "Loam::EventRedeliverySweepJob", schedule: "interval:300", scope: "tenant"
-      )
-    end
-
-    # Loam's Active Record layer — TenantRecord, Auditable, Eventful and the
-    # rest — is defined inside ActiveSupport.on_load(:active_record) in
-    # lib/loam.rb, so those constants exist only once something has referenced
-    # ActiveRecord::Base.
-    #
-    # Zeitwerk eager-loads app/models alphabetically. A host model that inherits
-    # from Loam::TenantRecord and sorts ahead of application_record.rb reaches
-    # the constant before anything has touched Base, and eager load dies with
-    # "uninitialized constant Loam::TenantRecord". Whether an app hits it
-    # depends on its model names, so it shows up on a rename rather than on the
-    # change that caused it.
-    #
-    # Referencing Base here fires the hook while load order is still the
-    # engine's to decide instead of each host app's. :eager_load! is late enough
-    # that every active_record.* initializer has applied its configuration, and
-    # it runs in every environment (in development it is a no-op that still
-    # executes), so lazily-loaded apps are settled by the same line.
-    initializer "loam.active_record_layer", before: :eager_load! do
-      ActiveRecord::Base
-    end
-
-    # Loam's own UI strings ship under lib/ (the gemspec packages lib/**/*), so
-    # register them on the app's I18n load path explicitly rather than relying on
-    # the default config/locales path (which the gem does not ship). An app
-    # overrides any key with its own config/locales/loam.<locale>.yml.
-    initializer "loam.i18n" do |app|
-      app.config.i18n.load_path += Dir[File.expand_path("locales/*.yml", __dir__)]
-    end
-
-    # lib/tasks/loam.rake (bin/rails loam:sync) is picked up by Rails::Engine's
-    # own lib/tasks loading. Loading it again from a `rake_tasks` block here
-    # would define the task twice and run its body twice.
-  end
-end

data/lib/loam/version.rb

@@ -1,3 +0,0 @@
-module Loam
-  VERSION = "0.1.1"
-end

data/lib/loam.rb

@@ -1,122 +0,0 @@
-require "loam/version"
-require "loam/errors"
-require "loam/current"
-require "loam/events"
-require "loam/policy"
-require "loam/lifecycle"
-require "loam/configs"
-require "loam/features"
-require "loam/auth_throttle"
-require "loam/dictionaries"
-require "loam/custom_field_index"
-require "loam/undo"
-require "loam/permissions"
-require "loam/telemetry"
-require "loam/eval"
-require "loam/mcp"
-require "loam/mcp/server"
-require "loam/progress"
-require "loam/cron"
-require "loam/scheduler"
-require "loam/csv"
-require "loam/export"
-require "loam/import"
-require "loam/bulk"
-require "loam/widgets"
-require "loam/dashboard"
-require "loam/overrides"
-require "loam/open_api"
-require "loam/encryption"
-require "loam/base32"
-require "loam/totp"
-require "loam/pending_actions"
-require "loam/perspectives"
-require "loam/record_locks"
-require "loam/event_stream"
-require "loam/enrichers"
-require "loam/search"
-require "loam/search/driver"
-require "loam/search/like_driver"
-require "loam/search/token_driver"
-require "loam/notifications"
-require "loam/sso"
-require "loam/business_rules"
-require "loam/webhooks"
-require "loam/inbound_webhooks"
-require "loam/durable_events"
-require "loam/engine" if defined?(Rails::Engine)
-
-module Loam
-  # The current tenant, or a loud failure. This is THE guardrail: tenant-scoped
-  # code paths call this, so a missing tenant context can never silently widen
-  # a query to all tenants.
-  def self.tenant!
-    Current.tenant or raise MissingTenantError
-  end
-
-  def self.tenant
-    Current.tenant
-  end
-
-  def self.actor
-    Current.actor
-  end
-
-  # Feature-string permission check for the current actor's role (see
-  # Loam::Permissions) — deny-by-default, wildcard-aware. `role:` overrides the
-  # actor's role. Returns false with no actor/role.
-  def self.can?(permission, role: nil)
-    role ||= Current.actor && Loam::Membership.find_by(user_id: Current.actor.id)&.role
-    Loam::Permissions.allow?(role, permission)
-  end
-
-  # The approval-gate seam. When a caller runs under :confirm (an MCP tool acting
-  # for an AI agent), a write should be STAGED for human approval via
-  # Loam::PendingActions.stage instead of committed. Loam does not intercept
-  # Active Record globally — this is the documented hook a write path checks.
-  def self.mutation_mode
-    Current.mutation_mode || :direct
-  end
-
-  def self.require_confirmation?
-    mutation_mode == :confirm
-  end
-
-  # Run a block with writes gated for approval. The one blessed way to enter
-  # confirm-mode; restores the previous mode afterwards.
-  def self.with_confirmation
-    previous = Current.mutation_mode
-    Current.mutation_mode = :confirm
-    yield
-  ensure
-    Current.mutation_mode = previous
-  end
-
-  # Run a block inside a tenant (and optional actor) context, restoring the
-  # previous context afterwards. The one blessed way to switch tenants.
-  def self.as_tenant(tenant, actor: nil)
-    previous_tenant = Current.tenant
-    previous_actor = Current.actor
-    Current.tenant = tenant
-    Current.actor = actor if actor
-    yield
-  ensure
-    Current.tenant = previous_tenant
-    Current.actor = previous_actor
-  end
-end
-
-ActiveSupport.on_load(:active_record) do
-  require "loam/generated_key"
-  require "loam/tenant_record"
-  require "loam/auditable"
-  require "loam/soft_deletable"
-  require "loam/eventful"
-  require "loam/custom_fields"
-  require "loam/workflow"
-  require "loam/searchable"
-  require "loam/encryptable"
-  require "loam/translatable"
-  require "loam/commentable"
-  require "loam/attachable"
-end

data/lib/tasks/loam_mcp.rake

@@ -1,20 +0,0 @@
-require "logger"
-
-namespace :loam do
-  namespace :mcp do
-    # Serve the Loam MCP server over stdio. Point an MCP client (Claude Code,
-    # Cursor, Codex) at `bin/rails loam:mcp:serve` with LOAM_MCP_TOKEN set to a
-    # Loam API token — the agent then acts as that token's user, in that tenant.
-    #
-    # stdout carries JSON-RPC only; every log is sent to stderr so it can't
-    # corrupt the stream.
-    desc "Serve the Loam MCP server over stdio (auth via LOAM_MCP_TOKEN)"
-    task serve: :environment do
-      Rails.logger = Logger.new($stderr)
-      ActiveRecord::Base.logger = Rails.logger
-      $stdout.sync = true
-
-      Loam::Mcp::Server.new.run
-    end
-  end
-end