lex-extinction 0.2.8 → 0.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d003d2c9912679ec68f06d9c09baf2f6dc327823e900bbcfa6573c295a7b233e
-  data.tar.gz: dada6a5d374c8dfe5b7ad6ec7585634d5ed889e60a28d4546db5716b5fada680
+  metadata.gz: ac2608cc19b731a702760c24eac379aca97d3877010ebdaae6a1922031153532
+  data.tar.gz: a528d184c0ba4b7c8851c095612f2fd10173b352e1a7a45bec12a99b24a1da17
 SHA512:
-  metadata.gz: 9826102ae5f6c1213adf8e3ae282b6025e0073061b2802659464e6bd188f15836b1df9e4439ce000ed859c8db13211909e965d350077cbb437bf2b74a544d071
-  data.tar.gz: 1d6bf45afff49e163e38a87eb4ffed46556a5f60f69a390e0a265a6b53d8cd7b28f7b71567d5e2dec34a7014c7058ca859a6d7f9efec3d700b625e7a26e01e25
+  metadata.gz: 1795646dd6dae2be9c7d087070a0b25e00177e1e33e1a3655ac8180a931046005dc187a7c4320ac8e0012f67e387122e667ff39171c96d82d3096337f8a14d58
+  data.tar.gz: f887f804a029b917c875a82c124a7d1acec7e4a9e124c9676b1cfc78ce06315550c0865a6afd2c0082425f9d6ca3b8867d94424a174bb7b0c188bbb1a804edf3

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

@@ -5,7 +5,7 @@ module Legion
     module Extinction
       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

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]

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

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Extinction
-      VERSION = '0.2.8'
+      VERSION = '0.2.10'
     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
@@ -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.8
+  version: 0.2.10
 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:
@@ -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