lex-extinction 0.2.8 → 0.2.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d003d2c9912679ec68f06d9c09baf2f6dc327823e900bbcfa6573c295a7b233e
-  data.tar.gz: dada6a5d374c8dfe5b7ad6ec7585634d5ed889e60a28d4546db5716b5fada680
+  metadata.gz: c454a27e6c0442dd5f1c306179413c52fb1d686c72fd40b68457d78247beaedd
+  data.tar.gz: 9427d520f2cd2ffd130fd68c37cdf0cc1eaecab78a3890bf7a87548eb60fc377
 SHA512:
-  metadata.gz: 9826102ae5f6c1213adf8e3ae282b6025e0073061b2802659464e6bd188f15836b1df9e4439ce000ed859c8db13211909e965d350077cbb437bf2b74a544d071
-  data.tar.gz: 1d6bf45afff49e163e38a87eb4ffed46556a5f60f69a390e0a265a6b53d8cd7b28f7b71567d5e2dec34a7014c7058ca859a6d7f9efec3d700b625e7a26e01e25
+  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

@@ -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.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.8
+  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