mlld 2.0.4 → 2.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36d855d7e5fa4638ceda66f9e7c7bde1edc7c0939d54a6dbe690bcc8435e81f8
-  data.tar.gz: d26e2fa2a32b69a325d859baec356331e01b7550e009b233186fa83bde0c1614
+  metadata.gz: ff041879477a16d48049a2d8e1d220960c88622f6d544db8b00af88ec4952707
+  data.tar.gz: a5b86461dc631d729c50e58822374bc0e08669ae98c4f96665febd9aa01ef449
 SHA512:
-  metadata.gz: 97cb037150d27a07589ac05a230470cb76f8a703b17e3b6efcc476446eee4ad02c2a8374f1a9fae6288477688587a11c909a00576cc0d13ebc0e55313a9be4fc
-  data.tar.gz: 2190023a9b5dbdab5c5752f4abbaec07e55d5fa614efb3182d2046d249ff2cb0023faa63889788277ca35e482b24d5808108d932e4695179ea6989e7b9fbddd7
+  metadata.gz: 819fbc89a98bdccffc5a012ece626f339caeb27b1143364dfcfe60e87670f320e2e7f1afc28aa1795584fab78a7f8bf73b4788490dfa845cf11c8ab34f7ea614
+  data.tar.gz: 79c752b1c2e328cb0f7f31330751764119a6bff7d5b4ec7839d06d57d6be024a7a84cfb84c6440d16a0a530a29a2389a498e8493211d1ae0b48d64568bed7fd8

data/README.md

@@ -94,3 +94,4 @@ puts handle.result
 
 - Each `Client` keeps one live RPC subprocess for repeated calls.
 - `ExecuteResult.state_writes` merges final-result writes and streamed `state:write` events.
+- `ExecuteResult.denials` collects structured guard/policy label-flow denials observed during execution.

data/lib/mlld.rb

@@ -19,7 +19,8 @@ module Mlld
   StateWrite = Struct.new(:path, :value, :timestamp, keyword_init: true)
   Metrics = Struct.new(:total_ms, :parse_ms, :evaluate_ms, keyword_init: true)
   Effect = Struct.new(:type, :content, :security, keyword_init: true)
-  ExecuteResult = Struct.new(:output, :state_writes, :exports, :effects, :metrics, keyword_init: true)
+  GuardDenial = Struct.new(:guard, :operation, :reason, :rule, :labels, :args, keyword_init: true)
+  ExecuteResult = Struct.new(:output, :state_writes, :exports, :effects, :denials, :metrics, keyword_init: true)
 
   Executable = Struct.new(:name, :params, :labels, keyword_init: true)
   Import = Struct.new(:from, :names, keyword_init: true)
@@ -57,8 +58,8 @@ module Mlld
       @client.send_cancel(@request_id)
     end
 
-    def update_state(path, value, timeout: nil)
-      @client.send_state_update(@request_id, path, value, timeout || @timeout)
+    def update_state(path, value, labels: nil, timeout: nil)
+      @client.send_state_update(@request_id, path, value, timeout || @timeout, labels: labels)
     end
 
     protected
@@ -200,6 +201,7 @@ module Mlld
       script,
       file_path: nil,
       payload: nil,
+      payload_labels: nil,
       state: nil,
       dynamic_modules: nil,
       dynamic_module_source: nil,
@@ -211,6 +213,7 @@ module Mlld
         script,
         file_path: file_path,
         payload: payload,
+        payload_labels: payload_labels,
         state: state,
         dynamic_modules: dynamic_modules,
         dynamic_module_source: dynamic_module_source,
@@ -224,6 +227,7 @@ module Mlld
       script,
       file_path: nil,
       payload: nil,
+      payload_labels: nil,
       state: nil,
       dynamic_modules: nil,
       dynamic_module_source: nil,
@@ -234,6 +238,8 @@ module Mlld
       params = { 'script' => script }
       params['filePath'] = file_path if file_path
       params['payload'] = payload unless payload.nil?
+      normalized_payload_labels = normalize_payload_labels(payload_labels)
+      params['payloadLabels'] = normalized_payload_labels if normalized_payload_labels
       params['state'] = state if state
       params['dynamicModules'] = dynamic_modules if dynamic_modules
       params['dynamicModuleSource'] = dynamic_module_source if dynamic_module_source
@@ -252,6 +258,7 @@ module Mlld
     def execute(
       filepath,
       payload = nil,
+      payload_labels: nil,
       state: nil,
       dynamic_modules: nil,
       dynamic_module_source: nil,
@@ -262,6 +269,7 @@ module Mlld
       execute_async(
         filepath,
         payload,
+        payload_labels: payload_labels,
         state: state,
         dynamic_modules: dynamic_modules,
         dynamic_module_source: dynamic_module_source,
@@ -274,6 +282,7 @@ module Mlld
     def execute_async(
       filepath,
       payload = nil,
+      payload_labels: nil,
       state: nil,
       dynamic_modules: nil,
       dynamic_module_source: nil,
@@ -283,6 +292,8 @@ module Mlld
     )
       params = { 'filepath' => filepath }
       params['payload'] = payload unless payload.nil?
+      normalized_payload_labels = normalize_payload_labels(payload_labels)
+      params['payloadLabels'] = normalized_payload_labels if normalized_payload_labels
       params['state'] = state if state
       params['dynamicModules'] = dynamic_modules if dynamic_modules
       params['dynamicModuleSource'] = dynamic_module_source if dynamic_module_source
@@ -309,7 +320,7 @@ module Mlld
       nil
     end
 
-    def send_state_update(request_id, path, value, timeout)
+    def send_state_update(request_id, path, value, timeout, labels: nil)
       unless path.is_a?(String) && !path.strip.empty?
         raise Error.new('state update path is required', code: 'INVALID_REQUEST')
       end
@@ -317,14 +328,17 @@ module Mlld
       resolved_timeout = resolve_timeout(timeout)
       max_wait = resolved_timeout || 2.0
       deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + max_wait
+      normalized_labels = normalize_label_list(labels)
 
       loop do
         begin
-          request('state:update', {
+          params = {
             'requestId' => request_id,
             'path' => path,
             'value' => value
-          }, resolved_timeout)
+          }
+          params['labels'] = normalized_labels if normalized_labels
+          request('state:update', params, resolved_timeout)
           return nil
         rescue Error => error
           raise unless error.code == 'REQUEST_NOT_FOUND'
@@ -335,6 +349,31 @@ module Mlld
       end
     end
 
+    def normalize_payload_labels(payload_labels)
+      return nil if payload_labels.nil?
+      return nil unless payload_labels.is_a?(Hash)
+
+      normalized = {}
+      payload_labels.each do |key, labels|
+        deduped = normalize_label_list(labels)
+        normalized[key] = deduped if deduped
+      end
+      normalized.empty? ? nil : normalized
+    end
+
+    def normalize_label_list(labels)
+      return nil if labels.nil?
+
+      raw = labels.is_a?(Array) ? labels : [labels]
+      normalized = raw
+        .select { |label| label.is_a?(String) }
+        .map(&:strip)
+        .reject(&:empty?)
+        .uniq
+
+      normalized.empty? ? nil : normalized
+    end
+
     def await_request(request_id, response_queue, timeout)
       state_write_events = []
       deadline = timeout ? Process.clock_gettime(Process::CLOCK_MONOTONIC) + timeout : nil
@@ -412,11 +451,25 @@ module Mlld
         )
       end.compact
 
+      denials = Array(result['denials']).map do |entry|
+        next unless entry.is_a?(Hash)
+
+        GuardDenial.new(
+          guard: entry['guard'],
+          operation: entry['operation'].to_s,
+          reason: entry['reason'].to_s,
+          rule: entry['rule'],
+          labels: Array(entry['labels']).select { |label| label.is_a?(String) },
+          args: entry['args'].is_a?(Hash) ? entry['args'] : nil
+        )
+      end.compact
+
       ExecuteResult.new(
         output: result['output'].to_s,
         state_writes: state_writes,
         exports: result.fetch('exports', []),
         effects: effects,
+        denials: denials,
         metrics: metrics
       )
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mlld
 version: !ruby/object:Gem::Version
-  version: 2.0.4
+  version: 2.0.5
 platform: ruby
 authors:
 - mlld-lang
@@ -39,7 +39,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Ruby wrapper for the mlld CLI
 test_files: []