brainzlab 0.1.24 → 0.1.26

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ab7b5c063e4371cad8decac72f4f0508c3ad4da1fedd8041a97c2f6601ee601
-  data.tar.gz: c3af39c85de1dee2a20cc4586809c5e7634fe8aa85f4145716b56e342119e48b
+  metadata.gz: e298648a456d207e9ec5eb9be700b6aa898fc9b77666a3afd3c737d9c126705e
+  data.tar.gz: b87707b7eb15cfb9dd11ca461203d0ccd1a7199bdd0ce972327381ecb675d592
 SHA512:
-  metadata.gz: 5581a93b79f51388c3d0ea6c5a1681418618bafbabfdb6e688210e7ae07cdf5d1a047fb414434c5f5171b95363734197555b5be6a2b6ad4c7f75cdf5740ce61f
-  data.tar.gz: 3a71004cb62f9a74fb3fdd5979da80757ffd06b30461bfb970217fb972c01c92904db9949bf52a7b48e4d5b5c20f2f745e63b908b4d49ea5c84ce3bebcc0e553
+  metadata.gz: f834d99194f33b06a00f18016879e83fefcd92b5ac4bd589804a7629a2b123699ecf58082923920a72384502dacc1e40ced04ccfb2b36ec2cf6c2791adab2e3a
+  data.tar.gz: 3999f40f6af0bb7b952baf59a35c78acbb38f89e41638824c86dc38a0319f0d964911fd3bc096bba272738c5bc1190777ce98a633a6050f9b7103b59ef8f13c7

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.25] - 2026-06-07
+
+### Added
+
+- **`BrainzLab::Cortex` management ("send") operations** — the Cortex client can now write feature flags, not just read them:
+  - `Cortex.create_flag(:key, name:, type:, description:, tags:)` → `POST /api/v1/flags`
+  - `Cortex.enable!(:key, environment:)` / `Cortex.disable!(:key, environment:)` → idempotent `POST /api/v1/flags/:key/toggle` with an explicit `enabled` flag
+  - `Cortex.set_percentage(:key, pct, environment:)` → `POST /api/v1/flags/:key/set_percentage`
+  - Writes clear the local flag cache. Reads (`enabled?`/`get`/`variant`/`all`/`list_flags`) and provisioning (`POST /api/v1/projects/provision`) now align with the Cortex service contract.
+
 ## [0.1.13] - 2026-02-24
 
 ### Fixed

data/lib/brainzlab/cortex/client.rb

@@ -75,6 +75,50 @@ module BrainzLab
         nil
       end
 
+      # Create (push) a flag definition. Returns the created flag hash or nil.
+      def create_flag(attrs)
+        response = request(:post, '/api/v1/flags', body: { flag: attrs })
+
+        return nil unless created_or_ok?(response)
+
+        JSON.parse(response.body, symbolize_names: true)[:flag]
+      rescue StandardError => e
+        log_error('create_flag', e)
+        nil
+      end
+
+      # Set a flag's enabled state in an environment. Returns the new state or nil.
+      def toggle(flag_name, enabled:, environment:)
+        response = request(
+          :post,
+          "/api/v1/flags/#{CGI.escape(flag_name)}/toggle",
+          body: { enabled: enabled, environment: environment }
+        )
+
+        return nil unless created_or_ok?(response)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('toggle', e)
+        nil
+      end
+
+      # Set a percentage flag's rollout in an environment. Returns the new state or nil.
+      def set_percentage(flag_name, percentage:, environment:)
+        response = request(
+          :post,
+          "/api/v1/flags/#{CGI.escape(flag_name)}/set_percentage",
+          body: { percentage: percentage, environment: environment }
+        )
+
+        return nil unless created_or_ok?(response)
+
+        JSON.parse(response.body, symbolize_names: true)
+      rescue StandardError => e
+        log_error('set_percentage', e)
+        nil
+      end
+
       def provision(project_id:, app_name:)
         response = request(
           :post,
@@ -91,6 +135,10 @@ module BrainzLab
 
       private
 
+      def created_or_ok?(response)
+        response.is_a?(Net::HTTPSuccess) || response.is_a?(Net::HTTPCreated)
+      end
+
       def request(method, path, headers: {}, body: nil, params: nil, use_service_key: false)
         uri = URI.parse("#{@base_url}#{path}")
 

data/lib/brainzlab/cortex.rb

@@ -123,6 +123,52 @@ module BrainzLab
         client.get_flag(flag_name.to_s)
       end
 
+      # === Management ("send" / write operations) ===
+
+      # Create (push) a new feature flag definition.
+      # @param flag_name [String, Symbol] flag key (lowercase, underscores)
+      # @param name [String] human-readable name (defaults to the key)
+      # @param type [String] boolean | percentage | variant | segment
+      # @return [Hash, nil] the created flag, or nil if disabled/unconfigured
+      #
+      # @example
+      #   BrainzLab::Cortex.create_flag(:new_checkout, name: "New Checkout")
+      def create_flag(flag_name, name: nil, type: 'boolean', description: nil, tags: [])
+        return nil unless writable?
+
+        client.create_flag(
+          key: flag_name.to_s,
+          name: name || flag_name.to_s,
+          flag_type: type,
+          description: description,
+          tags: tags
+        )
+      end
+
+      # Enable a flag in an environment (idempotent).
+      # @return [Hash, nil] the new state, or nil if disabled/unconfigured
+      def enable!(flag_name, environment: nil)
+        set_enabled(flag_name, true, environment: environment)
+      end
+
+      # Disable a flag in an environment (idempotent).
+      def disable!(flag_name, environment: nil)
+        set_enabled(flag_name, false, environment: environment)
+      end
+
+      # Set the rollout percentage (0-100) for a percentage flag.
+      def set_percentage(flag_name, percentage, environment: nil)
+        return nil unless writable?
+
+        result = client.set_percentage(
+          flag_name.to_s,
+          percentage: percentage,
+          environment: environment || BrainzLab.configuration.environment
+        )
+        clear_cache!
+        result
+      end
+
       # Clear the flag cache
       def clear_cache!
         cache.clear!
@@ -186,6 +232,26 @@ module BrainzLab
         BrainzLab.configuration.cortex_enabled
       end
 
+      # Write operations require the module on, a provisioned project, and a key.
+      def writable?
+        return false unless module_enabled?
+
+        ensure_provisioned!
+        BrainzLab.configuration.cortex_valid?
+      end
+
+      def set_enabled(flag_name, enabled, environment:)
+        return nil unless writable?
+
+        result = client.toggle(
+          flag_name.to_s,
+          enabled: enabled,
+          environment: environment || BrainzLab.configuration.environment
+        )
+        clear_cache!
+        result
+      end
+
       def merge_context(context)
         default_context = BrainzLab.configuration.cortex_default_context || {}
         thread_context = Thread.current[:cortex_context] || {}

data/lib/brainzlab/flux/buffer.rb

@@ -13,8 +13,10 @@ module BrainzLab
         @metrics = []
         @mutex = Mutex.new
         @last_flush = Time.now
+        @shutdown = false
 
         start_flush_thread
+        setup_at_exit
       end
 
       def add(type, data)
@@ -80,8 +82,10 @@ module BrainzLab
       end
 
       def start_flush_thread
-        Thread.new do
+        @flush_thread = Thread.new do
           loop do
+            break if @shutdown
+
             sleep FLUSH_INTERVAL
             begin
               flush! if size.positive?
@@ -90,6 +94,20 @@ module BrainzLab
             end
           end
         end
+        @flush_thread.abort_on_exception = false
+      end
+
+      # Flush whatever is buffered when the process exits (SIGTERM on deploy,
+      # graceful Puma worker shutdown) so the last batch isn't lost.
+      def setup_at_exit
+        at_exit do
+          @shutdown = true
+          begin
+            flush! if size.positive?
+          rescue StandardError
+            nil
+          end
+        end
       end
     end
   end

data/lib/brainzlab/flux.rb

@@ -164,12 +164,22 @@ module BrainzLab
       end
 
       def buffer
-        @buffer ||= Buffer.new(client)
+        # Fork-safety: the buffer owns a background flush thread that does NOT
+        # survive a fork (e.g. Puma workers). If we're now in a different
+        # process than the one that created the buffer, recreate it so each
+        # worker gets a live flush thread — otherwise web-emitted events/metrics
+        # buffer forever in the worker and never get sent.
+        if @buffer.nil? || @buffer_pid != Process.pid
+          @buffer = Buffer.new(client)
+          @buffer_pid = Process.pid
+        end
+        @buffer
       end
 
       def reset!
         @client = nil
         @buffer = nil
+        @buffer_pid = nil
         @provisioner = nil
         @provisioned = false
       end

data/lib/brainzlab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrainzLab
-  VERSION = '0.1.24'
+  VERSION = '0.1.26'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brainzlab
 version: !ruby/object:Gem::Version
-  version: 0.1.24
+  version: 0.1.26
 platform: ruby
 authors:
 - BrainzLab