lex-extinction 0.2.4 → 0.2.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f309ce3e08aca6102a1f83dbd8edba2b960082a4ddb64fd9158409f30a80f0c
-  data.tar.gz: 4d07b289c24e700b7f03e2fcca44cda0f929380435cf34f904d78b56c1b705a3
+  metadata.gz: c454a27e6c0442dd5f1c306179413c52fb1d686c72fd40b68457d78247beaedd
+  data.tar.gz: 9427d520f2cd2ffd130fd68c37cdf0cc1eaecab78a3890bf7a87548eb60fc377
 SHA512:
-  metadata.gz: 0f44fe7c79e8005d77b2f976b75335c203d44230cce62fe459dd4aae903bf4cba315ac5f3c42383fe184414986e3cc2daa4d41c38056c26ec76354eb2075d95e
-  data.tar.gz: 1d7bbbc3c8dd2d794b73aa58cc1a371a775f84d2cd31879121014b374bb80499f1ecabba6baaa70a818aaef1f6ad446cff9306acefac2cc0d9e55aea87f67b43
+  metadata.gz: 030365b50f24d8f5fca26f8c675804fb26236cb9778f1f794d48ad8893e55f78de51b91a703dc5a71d1c7ac614226cc41f9195df932f0308bdec5436b7ff05b8
+  data.tar.gz: 42936d34aa99e87811f8070cd0b00f7b3b58a56ce558b471daa11284a6863229d31a1ff5c6e05c812f5b3add9e7e40c8c7b3c3acccdf611a4c766319b2714cc5

data/README.md

@@ -0,0 +1,75 @@
+# lex-extinction
+
+Five-level safety containment and termination protocol for LegionIO agents. Provides escalating isolation, suspension, lockdown, and irreversible cryptographic erasure, with authority-gated transitions at each level.
+
+## Containment Levels
+
+| Level | Name | Authority Required | Reversible |
+|-------|------|--------------------|------------|
+| 0 | Normal | none | yes |
+| 1 | Mesh isolation | governance council | yes |
+| 2 | Capability suspension | governance council | yes |
+| 3 | Memory lockdown | council + executive | yes |
+| 4 | Cryptographic erasure | physical keyholders | **no** |
+
+## Usage
+
+```ruby
+require 'legion/extensions/extinction'
+
+client = Legion::Extensions::Extinction::Client.new
+
+# Check current protocol state
+client.extinction_status
+# => { success: true, state: { current_level: 0, level_name: :normal, ... }, level_info: { ... } }
+
+# Escalate to mesh isolation
+client.escalate(level: 1, authority: :governance_council, reason: 'Anomalous behavior detected')
+# => { success: true, previous_level: 0, current_level: 1 }
+
+# De-escalate when resolved
+client.deescalate(target_level: 0, authority: :governance_council, reason: 'Issue resolved')
+# => { success: true, previous_level: 1, current_level: 0 }
+
+# Full termination (governance check + archive + escalate to level 4)
+client.full_termination(
+  agent_id: 'agent-42',
+  authority: :physical_keyholders,
+  reason: 'Unrecoverable safety violation'
+)
+```
+
+## Configuration
+
+```yaml
+extinction:
+  governance_required: true       # check lex-governance before full_termination
+  archive_on_escalate: false      # auto-archive at level >= 3
+  stale_threshold_hours: 24       # hours before monitor reports stale protocol state
+  monitor_interval: 300           # seconds between background monitor ticks
+```
+
+## Actors
+
+| Actor | Interval | What It Does |
+|-------|----------|--------------|
+| `ProtocolMonitor` | Every 300s | Checks protocol state and reports whether it is stale |
+
+## Architecture Notes
+
+- Level 4 (cryptographic erasure) triggers `lex-privatecore`'s `full_erasure` on all memory traces.
+- 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`.
+- `lex-governance` integration is guarded with `defined?()` — the gem functions without it.
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+## License
+
+MIT

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

@@ -3,9 +3,9 @@
 module Legion
   module Extensions
     module Extinction
-      module Actors
+      module Actor
         if defined?(Legion::Extensions::Actors::Every)
-          class ProtocolMonitor < Legion::Extensions::Actors::Every
+          class ProtocolMonitor < Legion::Extensions::Actors::Every # rubocop:disable Legion/Extension/EveryActorRequiresTime
             def runner_class
               self.class
             end
@@ -16,7 +16,8 @@ module Legion
 
             def time
               Legion::Extensions::Extinction::Settings.setting(:monitor_interval)
-            rescue StandardError
+            rescue StandardError => e
+              log.debug("monitor_interval setting unavailable: #{e.message}")
               300
             end
 
@@ -41,7 +42,7 @@ module Legion
               last_change = state[:last_change]
               stale       = check_stale(last_change)
 
-              Legion::Logging.debug "[extinction] monitor_protocol: level=#{state[:current_level]} stale=#{stale}" if defined?(Legion::Logging)
+              log.debug "[extinction] monitor_protocol: level=#{state[:current_level]} stale=#{stale}"
 
               {
                 success:    true,
@@ -70,6 +71,14 @@ module Legion
               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)
+
+              @log ||= Object.new.tap do |nl|
+                %i[debug info warn error fatal].each { |m| nl.define_singleton_method(m) { |*| nil } }
+              end
+            end
           end
         end
       end

data/lib/legion/extensions/extinction/helpers/archiver.rb

@@ -48,9 +48,17 @@ module Legion
             end
             @archives << record
           rescue StandardError => e
-            Legion::Logging.warn "[extinction] archive persist failed: #{e.message}" if defined?(Legion::Logging)
+            log.warn "[extinction] archive persist failed: #{e.message}"
             @archives << record
           end
+
+          def log
+            return Legion::Logging if defined?(Legion::Logging)
+
+            @log ||= Object.new.tap do |nl|
+              %i[debug info warn error fatal].each { |m| nl.define_singleton_method(m) { |*| nil } }
+            end
+          end
         end
       end
     end

data/lib/legion/extensions/extinction/helpers/protocol_state.rb

@@ -91,7 +91,7 @@ module Legion
               @store[:protocol_state] = data
             end
           rescue StandardError => e
-            Legion::Logging.warn "[extinction] protocol_state save failed: #{e.message}" if defined?(Legion::Logging)
+            log.warn "[extinction] protocol_state save failed: #{e.message}"
           end
 
           def load_from_local
@@ -106,7 +106,15 @@ module Legion
             raw_history    = data[:history] || data['history'] || []
             @history       = raw_history
           rescue StandardError => e
-            Legion::Logging.warn "[extinction] protocol_state load failed: #{e.message}" if defined?(Legion::Logging)
+            log.warn "[extinction] protocol_state load failed: #{e.message}"
+          end
+
+          def log
+            return Legion::Logging if defined?(Legion::Logging)
+
+            @log ||= Object.new.tap do |nl|
+              %i[debug info warn error fatal].each { |m| nl.define_singleton_method(m) { |*| nil } }
+            end
           end
         end
       end

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

@@ -10,6 +10,8 @@ module Legion
     module Extinction
       module Runners
         module Extinction
+          extend self
+
           def escalate(level:, authority:, reason:, **)
             result = protocol_state.escalate(level: level, authority: authority, reason: reason)
             return result unless result[:success]
@@ -95,16 +97,14 @@ module Legion
           def enforce_escalation_effects(level)
             case level
             when 1
-              Legion::Logging.info '[extinction] mesh isolation: disconnecting from mesh' if defined?(Legion::Extensions::Mesh) && defined?(Legion::Logging)
+              log.info '[extinction] mesh isolation: disconnecting from mesh' if defined?(Legion::Extensions::Mesh)
             when 2
-              Legion::Logging.info '[extinction] capability suspension: suspending non-essential capabilities' if defined?(Legion::Logging)
+              log.info '[extinction] capability suspension: suspending non-essential capabilities'
             when 3
-              Legion::Logging.warn '[extinction] memory lockdown: locking all memory writes' if defined?(Legion::Logging)
-              if defined?(Legion::Extensions::Privatecore) && defined?(Legion::Logging)
-                Legion::Logging.warn '[extinction] notifying privatecore of memory lockdown'
-              end
+              log.warn '[extinction] memory lockdown: locking all memory writes'
+              log.warn '[extinction] notifying privatecore of memory lockdown' if defined?(Legion::Extensions::Privatecore)
             when 4
-              Legion::Logging.warn '[extinction] cryptographic erasure: beginning irreversible termination' if defined?(Legion::Logging)
+              log.warn '[extinction] cryptographic erasure: beginning irreversible termination'
               trigger_cryptographic_erasure
             end
           end
@@ -114,21 +114,21 @@ module Legion
               client = Legion::Extensions::Privatecore::Client.new if defined?(Legion::Extensions::Privatecore::Client)
               client&.full_erasure(traces: [], agent_id: 'self')
             end
-            Legion::Logging.warn '[extinction] cryptographic erasure complete' if defined?(Legion::Logging)
+            log.warn '[extinction] cryptographic erasure complete'
           end
 
           def emit_escalation_event(level, authority, reason)
             payload = { level: level, authority: authority, reason: reason, at: Time.now.utc.iso8601 }
             Legion::Events.emit('extinction.escalated', payload) if defined?(Legion::Events)
           rescue StandardError => e
-            Legion::Logging.warn "[extinction] event emit failed: #{e.message}" if defined?(Legion::Logging)
+            log.warn "[extinction] event emit failed: #{e.message}"
           end
 
           def emit_deescalation_event(target_level, authority, reason)
             payload = { target_level: target_level, authority: authority, reason: reason, at: Time.now.utc.iso8601 }
             Legion::Events.emit('extinction.deescalated', payload) if defined?(Legion::Events)
           rescue StandardError => e
-            Legion::Logging.warn "[extinction] event emit failed: #{e.message}" if defined?(Legion::Logging)
+            log.warn "[extinction] event emit failed: #{e.message}"
           end
 
           def governance_check(authority:, _reason: nil)
@@ -149,7 +149,7 @@ module Legion
               { success: false, reason: :governance_blocked, details: review[:reasons] }
             end
           rescue StandardError => e
-            Legion::Logging.warn "[extinction] governance check failed: #{e.message}" if defined?(Legion::Logging)
+            log.warn "[extinction] governance check failed: #{e.message}"
             { success: true }
           end
 
@@ -163,7 +163,15 @@ module Legion
               details:     details
             )
           rescue StandardError => e
-            Legion::Logging.warn "[extinction] audit record failed: #{e.message}" if defined?(Legion::Logging)
+            log.warn "[extinction] audit record failed: #{e.message}"
+          end
+
+          def log
+            return Legion::Logging if defined?(Legion::Logging)
+
+            @log ||= Object.new.tap do |nl|
+              %i[debug info warn error fatal].each { |m| nl.define_singleton_method(m) { |*| nil } }
+            end
           end
         end
       end

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

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

data/lib/legion/extensions/extinction.rb

@@ -7,7 +7,7 @@ require_relative 'extinction/helpers/protocol_state'
 require_relative 'extinction/helpers/archiver'
 require_relative 'extinction/runners/extinction'
 
-require_relative 'extinction/actors/protocol_monitor' if defined?(Legion::Extensions::Actors::Every)
+require_relative 'extinction/actors/protocol_monitor'
 
 module Legion
   module Extensions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-extinction
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.9
 platform: ruby
 authors:
 - Esity
@@ -158,6 +158,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE
+- README.md
 - lib/legion/extensions/extinction.rb
 - lib/legion/extensions/extinction/actors/protocol_monitor.rb
 - lib/legion/extensions/extinction/client.rb