e11y 0.2.0 → 1.1.0

data/RELEASE.md

@@ -20,14 +20,29 @@ For more control, see [Step-by-Step Release](#step-by-step-release) below.
 
 ## Pre-Release Checklist
 
+### Core
 - [ ] All changes documented in CHANGELOG.md under `[Unreleased]`
 - [ ] Version bumped: `rake release:bump`
-- [ ] All tests passing: `rake spec`
+- [ ] All tests passing: `rake spec:all` (unit + integration)
+- [ ] RuboCop clean: `bundle exec rubocop`
 - [ ] Changes committed
 - [ ] Git tag created
 - [ ] Published to RubyGems.org
 - [ ] GitHub release created
 
+### Documentation & Links
+- [ ] All doc links valid (ADRs in `docs/architecture/`, use cases in `docs/use_cases/`)
+- [ ] No broken references to deleted files (e.g. `docs/analysis/`, `docs/IMPLEMENTATION_PLAN.md`)
+- [ ] README, CONTRIBUTING, CLAUDE.md reference correct paths
+- [ ] All user-facing text in English (no Russian in docs/code comments)
+
+### Production Readiness
+- [ ] SECURITY.md present (if handling sensitive data)
+- [ ] LICENSE file present and correct
+- [ ] No TODO/FIXME in critical paths
+- [ ] Deprecation warnings documented (if any)
+- [ ] Breaking changes clearly called out in CHANGELOG
+
 ## Step-by-Step Release
 
 ### Step 0: Bump Version
@@ -53,7 +68,7 @@ git commit -m "Bump version to 0.2.0"
 
 ### Step 1: Prepare Release
 
-Run tests, build gem, create tag:
+Run tests, build both gems, create tag:
 
 ```bash
 rake release:prep
@@ -62,8 +77,14 @@ rake release:prep
 This will:
 - ✅ Check git status (fails if uncommitted changes)
 - ✅ Run full test suite
-- ✅ Build gem file
-- ✅ Create annotated git tag
+- ✅ Build **e11y** and **e11y-devtools** `.gem` files (devtools is built under `gems/e11y-devtools/`)
+- ✅ Create annotated git tag `v<e11y-version>` (tag follows the core gem only)
+
+Build gems without tests (e.g. after a failed spec run you already trust):
+
+```bash
+rake release:build_gems
+```
 
 Or manually:
 
@@ -71,8 +92,9 @@ Or manually:
 # Run all tests
 bundle exec rspec
 
-# Build gem
+# Build gems
 gem build e11y.gemspec
+(cd gems/e11y-devtools && gem build e11y-devtools.gemspec)
 
 # Create and push tag
 git tag -a v0.2.0 -m "Release v0.2.0"
@@ -99,10 +121,16 @@ rake release:gem_push
 ```
 
 This will:
-- ✅ Verify gem file exists
-- ✅ Prompt for confirmation
-- ✅ Push gem to RubyGems (requires MFA)
-- ✅ Show verification URL
+- ✅ Verify both `.gem` files exist (e11y in repo root, e11y-devtools under `gems/e11y-devtools/`)
+- ✅ Prompt once for confirmation
+- ✅ Push **e11y** first, then **e11y-devtools** (each `gem push` may ask for MFA)
+
+Push only one gem if needed:
+
+```bash
+rake release:rubygems:push_core      # e11y only
+rake release:rubygems:push_devtools  # e11y-devtools only
+```
 
 Or manually:
 
@@ -118,8 +146,9 @@ Or manually:
 # Sign in to RubyGems (one-time setup)
 gem signin
 
-# Push the gem (requires MFA)
+# Push the gems (requires MFA; e11y first — devtools depends on it)
 gem push e11y-0.1.0.gem
+gem push gems/e11y-devtools/e11y-devtools-0.1.0.gem
 ```
 
 Expected output:
@@ -181,7 +210,7 @@ bundle install
 ## 📚 Documentation
 
 - **Quick Start**: [README.md](https://github.com/arturseletskiy/e11y#quick-start)
-- **Architecture**: [docs/ADR-INDEX.md](https://github.com/arturseletskiy/e11y/blob/main/docs/ADR-INDEX.md)
+- **Architecture**: [docs/architecture/ADR-INDEX.md](https://github.com/arturseletskiy/e11y/blob/main/docs/architecture/ADR-INDEX.md)
 - **Benchmarks**: [benchmarks/README.md](https://github.com/arturseletskiy/e11y/blob/main/benchmarks/README.md)
 
 ## 🔥 What's New
@@ -192,7 +221,7 @@ See [CHANGELOG.md](https://github.com/arturseletskiy/e11y/blob/main/CHANGELOG.md
 - Event System with dry-schema validation
 - Pipeline Architecture (middleware-based)
 - 7 Adapters: Stdout, File, InMemory, Loki, Sentry, OpenTelemetry, Yabeda
-- 3 Buffer Types: RingBuffer, RequestScopedBuffer, AdaptiveBuffer
+- 3 Buffer Types: RingBuffer, EphemeralBuffer, AdaptiveBuffer
 - Reliability: Retry, Circuit Breaker, Dead Letter Queue
 
 ### SLO Tracking (Phase 3)

data/Rakefile

@@ -9,7 +9,8 @@
 #   rake release:full      # Complete release workflow (prep + git_push + gem_push)
 #   rake release:prep      # Run tests, build gem, create tag
 #   rake release:git_push  # Push to GitHub
-#   rake release:gem_push  # Publish to RubyGems
+#   rake release:gem_push  # Publish e11y + e11y-devtools to RubyGems
+#   rake release:build_gems # Build both .gem packages (no tests)
 #   rake spec:all          # Run all test suites
 #   rake spec:unit         # Run unit tests only (fast)
 #   rake spec:integration  # Run integration tests
@@ -20,6 +21,15 @@ require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 require "rubocop/rake_task"
 
+def e11y_devtools_specs_available?
+  # Devtools specs live in monorepo; run them when the directory exists
+  # (no need for gem in bundle — spec_helper loads lib via path)
+  File.directory?(File.join(__dir__, "gems/e11y-devtools/spec"))
+end
+
+# Built with: (cd gems/e11y-devtools && gem build …) — .gem stays in this directory
+E11Y_DEVTOOLS_GEM_DIR = File.expand_path("gems/e11y-devtools", __dir__).freeze
+
 RSpec::Core::RakeTask.new(:spec)
 
 RuboCop::RakeTask.new
@@ -36,7 +46,6 @@ namespace :spec do
   desc "Run integration tests (requires Rails, bundle install --with integration)"
   task :integration do
     # Run integration tests with explicit file patterns to avoid loading all specs
-    # This prevents test pollution from unit test files
     sh "INTEGRATION=true bundle exec rspec " \
        "spec/integration/*.rb " \
        "spec/e11y/adapters/*_spec.rb " \
@@ -49,13 +58,27 @@ namespace :spec do
     sh "bundle exec rspec spec/e11y/railtie_integration_spec.rb --tag railtie_integration"
   end
 
-  desc "Run all tests (unit + integration + railtie, ~1729 examples)"
+  desc "Run all tests (unit + memory + integration + railtie + cucumber)"
   task :all do
     puts "\n#{'=' * 80}"
     puts "Running UNIT tests (spec/e11y + top-level specs)..."
     puts "#{'=' * 80}\n"
     Rake::Task["spec:unit"].invoke
 
+    if e11y_devtools_specs_available?
+      puts "\n#{'=' * 80}"
+      puts "Running E11Y-DEVTOOLS unit tests (gems/e11y-devtools/spec/)..."
+      puts "#{'=' * 80}\n"
+      Rake::Task["spec:devtools"].invoke
+    else
+      puts "\n⏭️  Skipping e11y-devtools specs (gems/e11y-devtools/spec/ not found)"
+    end
+
+    puts "\n#{'=' * 80}"
+    puts "Running MEMORY tests (allocations, leaks, consumption)..."
+    puts "#{'=' * 80}\n"
+    Rake::Task["spec:memory"].invoke
+
     puts "\n#{'=' * 80}"
     puts "Running INTEGRATION tests (spec/integration)..."
     puts "#{'=' * 80}\n"
@@ -66,6 +89,15 @@ namespace :spec do
     puts "#{'=' * 80}\n"
     Rake::Task["spec:railtie"].invoke
 
+    if Rake::Task.task_defined?("cucumber:passing")
+      puts "\n#{'=' * 80}"
+      puts "Running CUCUMBER tests (features/, exclude @wip)..."
+      puts "#{'=' * 80}\n"
+      Rake::Task["cucumber:passing"].invoke
+    else
+      puts "\n⚠️  Skipping Cucumber (bundle install --with development)"
+    end
+
     puts "\n#{'=' * 80}"
     puts "✅ All test suites completed!"
     puts "#{'=' * 80}\n"
@@ -86,15 +118,31 @@ namespace :spec do
     sh "bundle exec rspec spec/e11y --tag benchmark"
   end
 
-  desc "Run ALL tests including benchmarks (very slow)"
+  desc "Run memory profiling specs (allocations, leaks, consumption)"
+  task :memory do
+    sh "bundle exec rspec " \
+       "spec/e11y/memory_spec.rb " \
+       "spec/e11y/event/base_benchmark_spec.rb " \
+       "--tag memory --format documentation"
+  end
+
+  desc "Run e11y-devtools unit tests (gems/e11y-devtools/spec/)"
+  task :devtools do
+    sh "bundle exec rspec gems/e11y-devtools/spec/ --tag ~integration --format progress"
+  end
+
+  desc "Run ALL tests including benchmarks and cucumber (very slow)"
   task :everything do
     puts "\n#{'=' * 80}"
-    puts "Running ALL tests (unit + integration + railtie + benchmarks)"
+    puts "Running ALL tests (unit + integration + railtie + cucumber + benchmarks)"
     puts "#{'=' * 80}\n"
     Rake::Task["spec:unit"].invoke
+    Rake::Task["spec:devtools"].invoke if e11y_devtools_specs_available?
     Rake::Task["spec:integration"].invoke
     Rake::Task["spec:railtie"].invoke
+    Rake::Task["cucumber:passing"].invoke if Rake::Task.task_defined?("cucumber:passing")
     Rake::Task["spec:benchmark"].invoke
+    Rake::Task["spec:memory"].invoke
 
     puts "\n#{'=' * 80}"
     puts "✅ All test suites including benchmarks completed!"
@@ -136,32 +184,32 @@ namespace :release do
   task :bump do
     require_relative "lib/e11y/version"
     current_version = E11y::VERSION
-    
+
     puts "\n#{'=' * 80}"
     puts "📝 Version Bump"
     puts "#{'=' * 80}\n"
     puts "Current version: #{current_version}"
     puts "\nEnter new version (e.g., 0.2.0, 1.0.0):"
-    
+
     new_version = $stdin.gets.chomp.strip
-    
+
     if new_version.empty?
       puts "❌ Error: Version cannot be empty"
       exit 1
     end
-    
+
     unless new_version.match?(/^\d+\.\d+\.\d+$/)
       puts "❌ Error: Invalid version format. Use semantic versioning (e.g., 0.2.0)"
       exit 1
     end
-    
+
     if new_version == current_version
       puts "⚠️  Warning: New version is the same as current version"
       puts "Continue anyway? (y/N)"
       response = $stdin.gets.chomp.downcase
-      exit 0 unless response == "y" || response == "yes"
+      exit 0 unless %w[y yes].include?(response)
     end
-    
+
     puts "\n[1/3] Updating lib/e11y/version.rb..."
     version_file = "lib/e11y/version.rb"
     version_content = File.read(version_file)
@@ -171,58 +219,60 @@ namespace :release do
     )
     File.write(version_file, updated_version_content)
     puts "✅ Updated: #{current_version} → #{new_version}"
-    
+
     puts "\n[2/3] Updating CHANGELOG.md..."
     changelog_file = "CHANGELOG.md"
     changelog_content = File.read(changelog_file)
-    
+
     # Check if there's an [Unreleased] section
+    today = Time.now.strftime("%Y-%m-%d")
     if changelog_content.include?("## [Unreleased]")
       # Replace [Unreleased] with version and date
-      today = Time.now.strftime("%Y-%m-%d")
       updated_changelog = changelog_content.sub(
-        /## \[Unreleased\]/,
+        "## [Unreleased]",
         "## [#{new_version}] - #{today}"
       )
-      
+
       # Add new [Unreleased] section at the top
+      unreleased = "## [Unreleased]\n\n### Added\n\n### Changed\n\n### Fixed\n\n"
+      unreleased += "### Deprecated\n\n### Removed\n\n### Security\n\n\\1"
       updated_changelog = updated_changelog.sub(
         /(## \[#{Regexp.escape(new_version)}\] - #{today})/,
-        "## [Unreleased]\n\n### Added\n\n### Changed\n\n### Fixed\n\n### Deprecated\n\n### Removed\n\n### Security\n\n\\1"
+        unreleased
       )
-      
+
       File.write(changelog_file, updated_changelog)
       puts "✅ Updated CHANGELOG.md:"
       puts "   - [Unreleased] → [#{new_version}] - #{today}"
       puts "   - Added new [Unreleased] section"
     else
       # No [Unreleased] section, just add version entry
-      today = Time.now.strftime("%Y-%m-%d")
-      
+
       # Find where to insert (after the header, before first version)
-      if changelog_content =~ /(## \[\d+\.\d+\.\d+\])/
-        updated_changelog = changelog_content.sub(
-          /(## \[\d+\.\d+\.\d+\])/,
-          "## [Unreleased]\n\n### Added\n\n### Changed\n\n### Fixed\n\n### Deprecated\n\n### Removed\n\n### Security\n\n## [#{new_version}] - #{today}\n\n### Added\n- Version bump\n\n\\1"
-        )
+
+      if /(## \[\d+\.\d+\.\d+\])/.match?(changelog_content)
+        new_section = "## [Unreleased]\n\n### Added\n\n### Changed\n\n### Fixed\n\n"
+        new_section += "### Deprecated\n\n### Removed\n\n### Security\n\n"
+        new_section += "## [#{new_version}] - #{today}\n\n### Added\n- Version bump\n\n\\1"
+        updated_changelog = changelog_content.sub(/(## \[\d+\.\d+\.\d+\])/, new_section)
       else
         # No previous versions, add after header
         header_end = changelog_content.index("\n\n") || 0
         header = changelog_content[0..header_end]
-        rest = changelog_content[header_end + 1..-1] || ""
+        rest = changelog_content[(header_end + 1)..] || ""
         updated_changelog = "#{header}\n## [#{new_version}] - #{today}\n\n### Added\n- Initial release\n\n#{rest}"
       end
-      
+
       File.write(changelog_file, updated_changelog)
       puts "✅ Added version [#{new_version}] - #{today} to CHANGELOG.md"
     end
-    
+
     puts "\n[3/3] Summary"
     puts "✅ Version bumped: #{current_version} → #{new_version}"
     puts "✅ Files updated:"
     puts "   - lib/e11y/version.rb"
     puts "   - CHANGELOG.md"
-    
+
     puts "\n#{'=' * 80}"
     puts "Next steps:"
     puts "  1. Review changes: git diff"
@@ -231,6 +281,31 @@ namespace :release do
     puts "#{'=' * 80}\n"
   end
 
+  desc "Build e11y and e11y-devtools .gem files (no tests; devtools built in its directory)"
+  task :build_gems do
+    require_relative "lib/e11y/version"
+    require_relative "gems/e11y-devtools/lib/e11y/devtools/version"
+
+    puts "\n[build] e11y v#{E11y::VERSION}..."
+    unless system("gem build e11y.gemspec")
+      puts "❌ Error: Failed to build e11y gem"
+      exit 1
+    end
+
+    puts "\n[build] e11y-devtools v#{E11y::Devtools::VERSION}..."
+    Dir.chdir(E11Y_DEVTOOLS_GEM_DIR) do
+      unless system("gem build e11y-devtools.gemspec")
+        puts "❌ Error: Failed to build e11y-devtools gem"
+        exit 1
+      end
+    end
+
+    devtools_artifact = File.join(E11Y_DEVTOOLS_GEM_DIR, "e11y-devtools-#{E11y::Devtools::VERSION}.gem")
+    puts "\n✅ Built:"
+    puts "   - e11y-#{E11y::VERSION}.gem"
+    puts "   - #{devtools_artifact}"
+  end
+
   desc "Prepare release: run tests, build gem, create git tag (safe)"
   task :prep do
     require_relative "lib/e11y/version"
@@ -256,13 +331,11 @@ namespace :release do
     end
     puts "✅ All tests passed"
 
-    # Step 3: Build gem
-    puts "\n[3/5] Building gem..."
-    unless system("gem build e11y.gemspec")
-      puts "❌ Error: Failed to build gem"
-      exit 1
-    end
-    puts "✅ Gem built: e11y-#{version}.gem"
+    # Step 3: Build gems (e11y + e11y-devtools)
+    puts "\n[3/5] Building gems..."
+    Rake::Task["release:build_gems"].invoke
+    require_relative "gems/e11y-devtools/lib/e11y/devtools/version"
+    puts "✅ Gems built: e11y-#{version}.gem + e11y-devtools-#{E11y::Devtools::VERSION}.gem"
 
     # Step 4: Create git tag
     puts "\n[4/5] Creating git tag..."
@@ -290,28 +363,108 @@ namespace :release do
     puts "     git push origin main"
     puts "     git push origin #{tag_name}"
     puts "  3. Publish to RubyGems:"
-    puts "     rake release:publish"
+    puts "     rake release:gem_push"
     puts "\n"
   end
 
-  desc "Publish gem to RubyGems.org (requires authentication, safe)"
+  namespace :rubygems do
+    desc "Publish e11y gem only"
+    task :push_core do
+      require_relative "lib/e11y/version"
+      gem_file = "e11y-#{E11y::VERSION}.gem"
+
+      puts "\n#{'=' * 80}"
+      puts "📤 Publishing e11y v#{E11y::VERSION} to RubyGems.org"
+      puts "#{'=' * 80}\n"
+
+      unless File.exist?(gem_file)
+        puts "❌ Error: Gem file not found: #{gem_file}"
+        puts "Run 'rake release:build_gems' or 'rake release:prep' first"
+        exit 1
+      end
+
+      puts "This will publish #{gem_file}"
+      puts "You may be prompted for RubyGems credentials and MFA."
+      puts "\nContinue? (y/N)"
+
+      response = $stdin.gets.chomp.downcase
+      unless %w[y yes].include?(response)
+        puts "❌ Publication cancelled"
+        exit 0
+      end
+
+      unless system("gem push #{gem_file}")
+        puts "\n❌ Error: Failed to publish e11y"
+        exit 1
+      end
+
+      puts "\n✅ Published e11y v#{E11y::VERSION}"
+      puts "Verify: https://rubygems.org/gems/e11y/versions/#{E11y::VERSION}"
+    end
+
+    desc "Publish e11y-devtools gem only"
+    task :push_devtools do
+      require_relative "gems/e11y-devtools/lib/e11y/devtools/version"
+      version = E11y::Devtools::VERSION
+      gem_file = File.join(E11Y_DEVTOOLS_GEM_DIR, "e11y-devtools-#{version}.gem")
+
+      puts "\n#{'=' * 80}"
+      puts "📤 Publishing e11y-devtools v#{version} to RubyGems.org"
+      puts "#{'=' * 80}\n"
+
+      unless File.exist?(gem_file)
+        puts "❌ Error: Gem file not found: #{gem_file}"
+        puts "Run 'rake release:build_gems' or 'rake release:prep' first"
+        exit 1
+      end
+
+      puts "This will publish #{gem_file}"
+      puts "You may be prompted for RubyGems credentials and MFA."
+      puts "\nContinue? (y/N)"
+
+      response = $stdin.gets.chomp.downcase
+      unless %w[y yes].include?(response)
+        puts "❌ Publication cancelled"
+        exit 0
+      end
+
+      unless system("gem push #{gem_file}")
+        puts "\n❌ Error: Failed to publish e11y-devtools"
+        exit 1
+      end
+
+      puts "\n✅ Published e11y-devtools v#{version}"
+      puts "Verify: https://rubygems.org/gems/e11y-devtools/versions/#{version}"
+    end
+  end
+
+  desc "Publish e11y then e11y-devtools to RubyGems.org (requires authentication, MFA)"
   task :gem_push do
     require_relative "lib/e11y/version"
-    version = E11y::VERSION
-    gem_file = "e11y-#{version}.gem"
+    require_relative "gems/e11y-devtools/lib/e11y/devtools/version"
+
+    core_gem = "e11y-#{E11y::VERSION}.gem"
+    devtools_gem = File.join(E11Y_DEVTOOLS_GEM_DIR, "e11y-devtools-#{E11y::Devtools::VERSION}.gem")
 
     puts "\n#{'=' * 80}"
-    puts "📤 Publishing e11y v#{version} to RubyGems.org"
+    puts "📤 Publishing to RubyGems.org"
     puts "#{'=' * 80}\n"
 
-    unless File.exist?(gem_file)
-      puts "❌ Error: Gem file not found: #{gem_file}"
-      puts "Run 'rake release:prep' first"
+    unless File.exist?(core_gem)
+      puts "❌ Error: Gem file not found: #{core_gem}"
+      puts "Run 'rake release:build_gems' or 'rake release:prep' first"
+      exit 1
+    end
+    unless File.exist?(devtools_gem)
+      puts "❌ Error: Gem file not found: #{devtools_gem}"
+      puts "Run 'rake release:build_gems' or 'rake release:prep' first"
       exit 1
     end
 
-    puts "This will publish #{gem_file} to RubyGems.org"
-    puts "You will be prompted for your RubyGems credentials and MFA code."
+    puts "This will publish (e11y first, then e11y-devtools):"
+    puts "  1. #{core_gem}"
+    puts "  2. #{devtools_gem}"
+    puts "\nYou may be prompted for RubyGems credentials and MFA for each push."
     puts "\nContinue? (y/N)"
 
     response = $stdin.gets.chomp.downcase
@@ -320,17 +473,19 @@ namespace :release do
       exit 0
     end
 
-    unless system("gem push #{gem_file}")
-      puts "\n❌ Error: Failed to publish gem"
-      puts "Make sure you have:"
-      puts "  1. RubyGems account (https://rubygems.org/sign_up)"
-      puts "  2. Signed in: gem signin"
-      puts "  3. MFA enabled on your account"
+    unless system("gem push #{core_gem}")
+      puts "\n❌ Error: Failed to publish e11y"
+      exit 1
+    end
+
+    unless system("gem push #{devtools_gem}")
+      puts "\n❌ Error: Failed to publish e11y-devtools (e11y may already be on RubyGems)"
       exit 1
     end
 
-    puts "\n✅ Successfully published e11y v#{version} to RubyGems.org!"
-    puts "\nVerify: https://rubygems.org/gems/e11y/versions/#{version}"
+    puts "\n✅ Successfully published both gems!"
+    puts "  e11y:         https://rubygems.org/gems/e11y/versions/#{E11y::VERSION}"
+    puts "  e11y-devtools: https://rubygems.org/gems/e11y-devtools/versions/#{E11y::Devtools::VERSION}"
   end
 
   desc "Push git changes and tag to GitHub (safe)"
@@ -396,19 +551,56 @@ namespace :release do
     puts "=" * 80
     puts "\nPost-release tasks:"
     puts "  1. Create GitHub release: https://github.com/arturseletskiy/e11y/releases/new"
-    puts "  2. Verify on RubyGems: https://rubygems.org/gems/e11y"
+    puts "  2. Verify on RubyGems: https://rubygems.org/gems/e11y and /gems/e11y-devtools"
     puts "  3. Update README badges"
     puts "  4. Announce on social media"
     puts "\n"
   end
 
-  desc "Clean up built gems"
+  desc "Clean up built gem files (repo root + gems/e11y-devtools)"
   task :clean do
     puts "🧹 Cleaning up gem files..."
     FileList["*.gem"].each do |gem_file|
       File.delete(gem_file)
       puts "  Deleted: #{gem_file}"
     end
+    FileList[File.join(E11Y_DEVTOOLS_GEM_DIR, "*.gem")].each do |gem_file|
+      File.delete(gem_file)
+      puts "  Deleted: #{gem_file}"
+    end
     puts "✅ Clean complete"
   end
 end
+
+# ---------------------------------------------------------------------------
+# Cucumber acceptance tests
+# ---------------------------------------------------------------------------
+begin
+  require "cucumber/rake/task"
+
+  namespace :cucumber do
+    desc "Run all Cucumber acceptance tests"
+    Cucumber::Rake::Task.new(:all) do |t|
+      t.cucumber_opts = ["--format", "progress", "features/"]
+    end
+
+    desc "Run only @wip (known-bug) Cucumber scenarios"
+    Cucumber::Rake::Task.new(:wip) do |t|
+      t.cucumber_opts = ["--tags", "@wip", "--format", "progress", "features/"]
+    end
+
+    desc "Run passing Cucumber scenarios (exclude @wip)"
+    Cucumber::Rake::Task.new(:passing) do |t|
+      # Quote tag expression so shell keeps "not @wip" as one arg (Cucumber::Rake::Task uses cmd.join(' '))
+      t.cucumber_opts = ["--tags", '"not @wip"', "--format", "progress", "features/"]
+    end
+  end
+
+  desc "Run all Cucumber acceptance tests (alias for cucumber:all)"
+  task cucumber: "cucumber:all"
+rescue LoadError
+  desc "Cucumber not available — install with: bundle install --with development"
+  task :cucumber do
+    warn "Cucumber gem is not available. Run: bundle install --with development"
+  end
+end

data/config/README.md

@@ -80,4 +80,4 @@ Edit `docker-compose.yml` and change port mappings.
 
 ⚠️ **This is for TESTING ONLY!** Do not use these configurations in production.
 
-For production setup, see `docs/guides/production-deployment.md` (Phase 5).
+For production setup, see [QUICK-START](../docs/QUICK-START.md) and [CONFIGURATION](../docs/CONFIGURATION.md).

data/config/loki-local-config.yaml

@@ -26,6 +26,18 @@ schema_config:
         prefix: index_
         period: 24h
 
+# Fast flush for integration tests
+ingester:
+  chunk_idle_period: 1s       # Flush chunks after 1 second of inactivity
+  chunk_retain_period: 1s     # Keep chunks in memory for 1 second before flush
+  max_chunk_age: 2s           # Force flush after 2 seconds
+  chunk_target_size: 0        # Disable size-based flush delay
+  chunk_encoding: snappy
+  wal:
+    enabled: true
+    dir: /tmp/loki/wal
+    replay_memory_ceiling: 100MB
+
 ruler:
   alertmanager_url: http://localhost:9093
 

data/config/otel-collector-config.yaml

@@ -0,0 +1,44 @@
+# OpenTelemetry Collector config for E11y integration tests
+# Receives OTLP (logs, traces, metrics) and exports to debug + Loki
+#
+# Usage: docker compose up -d otel-collector
+# App sends to: http://localhost:4318 (HTTP) or localhost:4317 (gRPC)
+
+receivers:
+  otlp:
+    protocols:
+      grpc:
+        endpoint: 0.0.0.0:4317
+      http:
+        endpoint: 0.0.0.0:4318
+
+processors:
+  batch:
+    timeout: 5s
+    send_batch_size: 1024
+
+exporters:
+  debug:
+    verbosity: detailed
+    sampling_initial: 5
+    sampling_thereafter: 200
+
+  # Forward logs to Loki (same backend as direct Loki adapter)
+  # Requires contrib image: otel/opentelemetry-collector-contrib
+  loki:
+    endpoint: http://loki:3100/loki/api/v1/push
+
+service:
+  pipelines:
+    logs:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [debug, loki]
+    traces:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [debug]
+    metrics:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [debug]

data/cucumber.yml

@@ -0,0 +1 @@
+default: --publish-quiet