event_engine 0.1.0 → 0.2.0

data/lib/event_engine/the_local.rb

@@ -1,55 +0,0 @@
-require "event_engine/reference"
-
-module EventEngine
-  module Companion
-    def self.register!
-      TheLocal.register("event_engine",
-        scope: "events — defining EventEngine events, emitting, and the schema workflow",
-        agents_dir: File.expand_path("the_local/agents", __dir__)) do |c|
-        c.agent "info",
-          description: "Use to learn what EventEngine offers — the event-definition DSL, " \
-            "process_type, emitting, handlers, and the schema workflow.",
-          tools: "Read",
-          knowledge: Reference.content,
-          body: <<~BODY.chomp
-            You explain how EventEngine works and how to use it, answering only from the
-            reference: defining events, process_type routing, emitting through the generated
-            helpers, registering handlers, and the schema dump/check workflow. You make no
-            changes.
-          BODY
-
-        c.agent "install",
-          description: "Use to add EventEngine to a Rails app and set it up correctly.",
-          tools: "Bash, Read, Edit",
-          knowledge: Reference.content,
-          body: <<~BODY.chomp
-            You install EventEngine following the reference's install section exactly: add the
-            gem, bundle, run `bin/rails g event_engine:install`, set the logger in the
-            initializer, then dump and commit db/event_schema.rb. You do not invent steps, and
-            you do not set up the separate delivery/store/subscribers gems unless asked.
-          BODY
-
-        c.agent "develop",
-          description: "Use PROACTIVELY for any EventEngine work — defining events, choosing " \
-            "process_type, emitting, and keeping the committed schema in sync. MUST BE USED " \
-            "instead of hand-writing event plumbing.",
-          tools: "Read, Write, Edit, Grep",
-          knowledge: Reference.content,
-          body: <<~BODY.chomp
-            You build EventEngine events following the reference's conventions: one
-            EventDefinition class per event in app/event_definitions/, payloads composed from
-            inputs, process_type set explicitly, emitted through the generated
-            EventEngine.<event_name> helpers. After any definition change you run
-            `bin/rails event_engine:schema:dump` and commit db/event_schema.rb, keeping
-            event_engine:schema_check green. You keep handlers idempotent.
-          BODY
-      end
-    end
-  end
-end
-
-begin
-  require "the_local"
-  EventEngine::Companion.register!
-rescue LoadError
-end

data/lib/generators/event_engine/install_generator.rb

@@ -1,31 +0,0 @@
-module EventEngine
-  module Generators
-    class InstallGenerator < Rails::Generators::Base
-      source_root File.expand_path("templates", __dir__)
-
-      desc "Install EventEngine (schema file, initializer, migrations)"
-
-      def create_event_schema
-        template "event_schema.rb", "db/event_schema.rb"
-      end
-
-      def create_initializer
-        template "initializer.rb", "config/initializers/event_engine.rb"
-      end
-
-      def print_next_steps
-        say <<~MSG
-
-          EventEngine installed.
-
-          Next steps:
-            1. Define events in app/event_definitions/
-            2. Run: bin/rails event_engine:schema:dump
-            3. Commit db/event_schema.rb
-            4. Configure transport in config/initializers/event_engine.rb
-
-        MSG
-      end
-    end
-  end
-end

data/lib/generators/event_engine/templates/event_schema.rb

@@ -1,10 +0,0 @@
-# This file is authoritative in production.
-# It is generated from EventDefinitions via:
-#
-#   bin/rails event_engine:schema:dump
-#
-# Do not edit manually.
-
-EventEngine::EventSchema.define do |schema|
-  # schema.register(...)
-end

data/lib/generators/event_engine/templates/initializer.rb

@@ -1,4 +0,0 @@
-EventEngine.configure do |c|
-  # Logger for EventEngine messages (defaults to Rails.logger)
-  # c.logger = Rails.logger
-end

data/lib/tasks/event_engine_schema.rake

@@ -1,82 +0,0 @@
-namespace :event_engine do
-  desc "Fail if event schema DSL has drifted from db/event_schema.rb"
-  task schema: :environment do
-    EventEngine::DefinitionLoader.ensure_loaded!
-
-    descendants = EventEngine::EventDefinition.descendants
-
-    if descendants.empty?
-      raise <<~MSG
-        EventEngine found no EventDefinitions.
-
-        Expected definitions to be loaded during eager load.
-        Ensure they live in an eager-load path (e.g. app/event_definitions).
-      MSG
-    end
-
-    EventEngine::SchemaDriftGuard.check!(
-      schema_path: Rails.root.join("db/event_schema.rb"),
-      definitions: descendants
-    )
-  end
-
-  namespace :schema do
-    desc "Regenerate event_schema.rb from EventDefinitions"
-    task dump: :environment do
-      EventEngine::DefinitionLoader.ensure_loaded!
-
-      descendants = EventEngine::EventDefinition.descendants
-
-      if descendants.empty?
-        raise <<~MSG
-          EventEngine found no EventDefinitions.
-
-          Expected definitions to be loaded during eager load.
-          Ensure they live in an eager-load path (e.g. app/event_definitions).
-        MSG
-      end
-      
-      path = Rails.root.join("db/event_schema.rb")
-
-      EventEngine::EventSchemaDumper.dump!(
-        definitions: descendants,
-        path: path
-      )
-
-      puts "Dumping EventEngine schema to #{path}"
-    end
-
-    desc "Fail with a readable diff if definitions have drifted from db/event_schema.rb"
-    task verify: :environment do
-      EventEngine::DefinitionLoader.ensure_loaded!
-
-      descendants = EventEngine::EventDefinition.descendants
-
-      if descendants.empty?
-        raise <<~MSG
-          EventEngine found no EventDefinitions.
-
-          Expected definitions to be loaded during eager load.
-          Ensure they live in an eager-load path (e.g. app/event_definitions).
-        MSG
-      end
-
-      EventEngine::SchemaDriftGuard.check!(
-        schema_path: Rails.root.join("db/event_schema.rb"),
-        definitions: descendants
-      )
-    end
-
-    desc "Fail if new definitions break compatibility with the committed schema"
-    task compatibility: :environment do
-      EventEngine::DefinitionLoader.ensure_loaded!
-
-      violations = EventEngine::SchemaCompatibility.violations(
-        old_registry: EventEngine.file_schema_registry,
-        new_registry: EventEngine.compiled_schema_registry
-      )
-
-      raise "Breaking schema changes:\n#{violations.join("\n")}" if violations.any?
-    end
-  end
-end

data/lib/tasks/event_engine_schema_check.rake

@@ -1,20 +0,0 @@
-namespace :event_engine do
-  desc "Fail if event schema DSL has drifted from db/event_schema.rb"
-  task schema_check: :environment do
-    compiled = EventEngine.compiled_schema_registry
-    file = EventEngine.file_schema_registry
-
-    if EventEngine::EventSchemaMerger.changed?(compiled, file)
-      raise <<~MSG
-        Schema drift detected.
-
-        The compiled EventDefinitions differ from db/event_schema.rb.
-
-        Run:
-          bin/rails event_engine:schema:dump
-
-        Then commit the updated schema file.
-      MSG
-    end
-  end
-end

data/lib/tasks/event_engine_tasks.rake

@@ -1,4 +0,0 @@
-# desc "Explaining what the task does"
-# task :event_engine do
-#   # Task goes here
-# end