lex-extinction 0.2.9 → 0.2.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c454a27e6c0442dd5f1c306179413c52fb1d686c72fd40b68457d78247beaedd
-  data.tar.gz: 9427d520f2cd2ffd130fd68c37cdf0cc1eaecab78a3890bf7a87548eb60fc377
+  metadata.gz: c3fa77e1ce3dafb0879e5b18386cc8056796e20861855c63a7fc73df4507a6f5
+  data.tar.gz: d061c82dd9fda61be0ddec8221018b85fb258237508d42253e36b0643ce9ac7d
 SHA512:
-  metadata.gz: 030365b50f24d8f5fca26f8c675804fb26236cb9778f1f794d48ad8893e55f78de51b91a703dc5a71d1c7ac614226cc41f9195df932f0308bdec5436b7ff05b8
-  data.tar.gz: 42936d34aa99e87811f8070cd0b00f7b3b58a56ce558b471daa11284a6863229d31a1ff5c6e05c812f5b3add9e7e40c8c7b3c3acccdf611a4c766319b2714cc5
+  metadata.gz: 80939e380ae28829beeef151e69a0556339f3ca93d1f441728aa0c34efd9b4a6cfbeb30163dd2fdb664d5616ed6d4d792fb0b214bf389374d67b31f131a1cec0
+  data.tar.gz: 38990bc6101b79618fa1b0115c826c863804326ec7f0918edd7a276e36ced5685a0e05206f236f7375843a367a4498ecc24c17738dbfb8b6697cdfdcce8bff73

data/README.md

@@ -12,6 +12,12 @@ Five-level safety containment and termination protocol for LegionIO agents. Prov
 | 3 | Memory lockdown | council + executive | yes |
 | 4 | Cryptographic erasure | physical keyholders | **no** |
 
+## Installation
+
+```ruby
+gem 'lex-extinction'
+```
+
 ## Usage
 
 ```ruby
@@ -39,6 +45,17 @@ client.full_termination(
 )
 ```
 
+## Runner Methods
+
+| Method | Key Args | Returns |
+|--------|----------|---------|
+| `escalate` | `level:, authority:, reason:` | `{ success:, previous_level:, current_level: }` |
+| `deescalate` | `target_level:, authority:, reason:` | `{ success:, previous_level:, current_level: }` |
+| `extinction_status` | — | `{ success:, state:, level_info: }` |
+| `monitor_protocol` | — | `{ success:, state:, stale:, checked_at: }` |
+| `archive_agent` | `agent_id:, reason:, metadata: {}` | `{ success:, archive: }` |
+| `full_termination` | `agent_id:, authority:, reason:` | governance check → archive → escalate(4) |
+
 ## Configuration
 
 ```yaml
@@ -57,9 +74,9 @@ extinction:
 
 ## Architecture Notes
 
-- Level 4 (cryptographic erasure) triggers `lex-privatecore`'s `full_erasure` on all memory traces.
+- Level 4 (cryptographic erasure) triggers `lex-privatecore`'s `full_erasure` on all memory traces (guarded with `defined?`).
 - State is persisted to `Legion::Data::Local` when available; falls back to in-memory storage.
-- All escalations/de-escalations fire `Legion::Events` notifications and write to `Legion::Extensions::Audit`.
+- All escalations/de-escalations fire `Legion::Events` notifications (`extinction.escalated`, `extinction.deescalated`, `extinction.level_N`) and write to `Legion::Extensions::Audit`.
 - `lex-governance` integration is guarded with `defined?()` — the gem functions without it.
 
 ## Development

data/lib/legion/extensions/extinction/actors/protocol_monitor.rb

@@ -7,7 +7,7 @@ module Legion
         if defined?(Legion::Extensions::Actors::Every)
           class ProtocolMonitor < Legion::Extensions::Actors::Every # rubocop:disable Legion/Extension/EveryActorRequiresTime
             def runner_class
-              self.class
+              Legion::Extensions::Extinction::Runners::Extinction
             end
 
             def runner_function
@@ -26,7 +26,7 @@ module Legion
             end
 
             def use_runner?
-              false
+              true
             end
 
             def check_subtask?
@@ -37,41 +37,8 @@ module Legion
               false
             end
 
-            def monitor_protocol(**)
-              state = build_state
-              last_change = state[:last_change]
-              stale       = check_stale(last_change)
-
-              log.debug "[extinction] monitor_protocol: level=#{state[:current_level]} stale=#{stale}"
-
-              {
-                success:    true,
-                state:      state,
-                stale:      stale,
-                checked_at: Time.now.utc.iso8601
-              }
-            end
-
             private
 
-            def build_state
-              {
-                current_level: 0,
-                level_name:    :normal,
-                reversible:    true,
-                history_count: 0,
-                last_change:   nil
-              }
-            end
-
-            def check_stale(last_change)
-              return false unless last_change
-
-              threshold_hours = Legion::Extensions::Extinction::Settings.setting(:stale_threshold_hours)
-              changed_at      = Time.parse(last_change[:at]) rescue nil # rubocop:disable Style/RescueModifier
-              changed_at && (Time.now.utc - changed_at) > (threshold_hours * 3600)
-            end
-
             def log
               return Legion::Logging if defined?(Legion::Logging)
 

data/lib/legion/extensions/extinction/runners/extinction.rb

@@ -95,26 +95,38 @@ module Legion
           end
 
           def enforce_escalation_effects(level)
+            reason = "escalation to level #{level}"
             case level
             when 1
-              log.info '[extinction] mesh isolation: disconnecting from mesh' if defined?(Legion::Extensions::Mesh)
+              # Mesh disconnect depends on lex-mesh responding to the extinction.level_1 event
+              log.info '[extinction] mesh isolation: disconnecting from mesh'
+              emit_level_event(level, reason)
             when 2
-              log.info '[extinction] capability suspension: suspending non-essential capabilities'
+              # Capability suspension depends on extensions responding to the extinction.level_2 event
+              log.warn '[extinction] capability suspension: suspending non-essential capabilities'
+              emit_level_event(level, reason)
             when 3
+              # Memory write lock depends on lex-privatecore responding to the extinction.level_3 event
               log.warn '[extinction] memory lockdown: locking all memory writes'
               log.warn '[extinction] notifying privatecore of memory lockdown' if defined?(Legion::Extensions::Privatecore)
+              emit_level_event(level, reason)
             when 4
               log.warn '[extinction] cryptographic erasure: beginning irreversible termination'
+              emit_level_event(level, reason)
               trigger_cryptographic_erasure
             end
           end
 
           def trigger_cryptographic_erasure
             if defined?(Legion::Extensions::Privatecore::Runners::Privatecore)
+              log.info '[extinction] invoking privatecore cryptographic erasure'
               client = Legion::Extensions::Privatecore::Client.new if defined?(Legion::Extensions::Privatecore::Client)
               client&.full_erasure(traces: [], agent_id: 'self')
             end
             log.warn '[extinction] cryptographic erasure complete'
+          rescue StandardError => e
+            log.error "[extinction] cryptographic erasure FAILED: #{e.message}"
+            raise
           end
 
           def emit_escalation_event(level, authority, reason)
@@ -131,16 +143,22 @@ module Legion
             log.warn "[extinction] event emit failed: #{e.message}"
           end
 
-          def governance_check(authority:, _reason: nil)
+          def emit_level_event(level, reason)
+            return unless defined?(Legion::Events)
+
+            log.info "[extinction] emitting extinction.level_#{level} event"
+            Legion::Events.emit("extinction.level_#{level}", { level: level, reason: reason, at: Time.now.utc.iso8601 })
+          rescue StandardError => e
+            log.error "[extinction] level event emit failed: #{e.message}"
+          end
+
+          def governance_check(authority:, level: 4, _reason: nil)
             return { success: true } unless Legion::Extensions::Extinction::Settings.setting(:governance_required)
-            return { success: true } unless defined?(Legion::Extensions::Governance)
-
-            review = Legion::Extensions::Governance::Runners::Governance.review_transition(
-              worker_id:    'extinction',
-              from_state:   'active',
-              to_state:     'terminated',
-              principal_id: authority.to_s,
-              worker_owner: nil
+            return { success: true } unless defined?(Legion::Extensions::Agentic::Social::Governance)
+
+            log.info "[extinction] governance check: authority=#{authority} level=#{level}"
+            review = Legion::Extensions::Agentic::Social::Governance::Runners::Governance.validate_action(
+              action: "extinction_escalate_#{level}"
             )
 
             if review[:allowed]
@@ -149,8 +167,8 @@ module Legion
               { success: false, reason: :governance_blocked, details: review[:reasons] }
             end
           rescue StandardError => e
-            log.warn "[extinction] governance check failed: #{e.message}"
-            { success: true }
+            log.error "[extinction] governance check failed: #{e.message}"
+            { success: false, reason: 'governance unavailable' }
           end
 
           def record_audit(action:, details: {})

data/lib/legion/extensions/extinction/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Extinction
-      VERSION = '0.2.9'
+      VERSION = '0.2.11'
     end
   end
 end

data/lib/legion/extensions/extinction.rb

@@ -17,6 +17,18 @@ module Legion
       def self.data_required? = false
 
       def self.remote_invocable? = false
+
+      def self.mcp_tools?
+        false
+      end
+
+      def self.mcp_tools_deferred?
+        false
+      end
+
+      def self.transport_required?
+        false
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-extinction
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.2.11
 platform: ruby
 authors:
 - Esity
@@ -125,30 +125,30 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.62'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.62'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.25'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.25'
+        version: '0'
 description: Five-level extinction protocol with archival, audit trail, governance
   gates, and configurable settings
 email: