lex-coldstart 0.1.0

data/spec/local_persistence_spec.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'sequel'
+require 'sequel/extensions/migration'
+
+RSpec.describe 'lex-coldstart local persistence' do
+  let(:db) { Sequel.sqlite }
+  let(:migration_path) do
+    File.join(__dir__, '..', 'lib', 'legion', 'extensions', 'coldstart', 'local_migrations')
+  end
+
+  before do
+    Sequel::TimestampMigrator.new(db, migration_path).run
+    stub_const('Legion::Data::Local', local_mod)
+  end
+
+  let(:local_mod) do
+    db_ref = db
+    Module.new do
+      define_singleton_method(:connected?) { true }
+      define_singleton_method(:connection) { db_ref }
+    end
+  end
+
+  def fresh_bootstrap
+    Legion::Extensions::Coldstart::Helpers::Bootstrap.new
+  end
+
+  describe 'save and load round-trip' do
+    it 'persists firmware_loaded after load_firmware' do
+      b = fresh_bootstrap
+      b.load_firmware
+      b2 = fresh_bootstrap
+      expect(b2.firmware_loaded).to be true
+    end
+
+    it 'persists observation_count after record_observation calls' do
+      b = fresh_bootstrap
+      b.begin_imprint
+      3.times { b.record_observation }
+      b2 = fresh_bootstrap
+      expect(b2.observation_count).to eq(3)
+    end
+
+    it 'persists calibration_state as a symbol' do
+      b = fresh_bootstrap
+      b.begin_imprint
+      b2 = fresh_bootstrap
+      expect(b2.calibration_state).to eq(:imprinting)
+    end
+  end
+
+  describe 'started_at preservation (imprint window survives restarts)' do
+    it 'restores started_at so the 7-day window continues from the original time' do
+      b = fresh_bootstrap
+      b.begin_imprint
+      original_started_at = b.started_at
+
+      b2 = fresh_bootstrap
+      expect(b2.started_at).not_to be_nil
+      expect(b2.started_at.to_i).to be_within(1).of(original_started_at.to_i)
+    end
+
+    it 'reports imprint still active after reload within the 7-day window' do
+      b = fresh_bootstrap
+      b.begin_imprint
+      b2 = fresh_bootstrap
+      expect(b2.imprint_active?).to be true
+    end
+
+    it 'does not reset started_at to nil on second boot' do
+      b = fresh_bootstrap
+      b.begin_imprint
+      b2 = fresh_bootstrap
+      expect(b2.started_at).not_to be_nil
+    end
+  end
+
+  describe 'calibration_state symbol round-trip' do
+    %i[not_started imprinting baseline_established calibrated].each do |state|
+      it "persists and restores :#{state}" do
+        fresh_bootstrap
+        # Force the state directly through the DB to test all symbol variants
+        db[:bootstrap_state].where(id: 1).delete
+        db[:bootstrap_state].insert(
+          id:                1,
+          started_at_i:      nil,
+          observation_count: 0,
+          firmware_loaded:   false,
+          calibration_state: state.to_s
+        )
+        b2 = fresh_bootstrap
+        expect(b2.calibration_state).to eq(state)
+      end
+    end
+  end
+
+  describe 'graceful no-op when Local is not connected' do
+    before do
+      stub_const('Legion::Data::Local', disconnected_mod)
+    end
+
+    let(:disconnected_mod) do
+      Module.new do
+        define_singleton_method(:connected?) { false }
+      end
+    end
+
+    it 'does not raise on begin_imprint' do
+      expect { fresh_bootstrap.begin_imprint }.not_to raise_error
+    end
+
+    it 'does not raise on load_firmware' do
+      expect { fresh_bootstrap.load_firmware }.not_to raise_error
+    end
+
+    it 'does not raise on record_observation' do
+      b = fresh_bootstrap
+      b.begin_imprint
+      expect { b.record_observation }.not_to raise_error
+    end
+
+    it 'leaves state at defaults when nothing is persisted' do
+      b = fresh_bootstrap
+      expect(b.started_at).to be_nil
+      expect(b.observation_count).to eq(0)
+      expect(b.firmware_loaded).to be false
+      expect(b.calibration_state).to eq(:not_started)
+    end
+  end
+
+  describe 'graceful no-op when Legion::Data::Local is not defined' do
+    it 'does not raise on initialize when constant is absent' do
+      hide_const('Legion::Data::Local')
+      expect { fresh_bootstrap }.not_to raise_error
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'bundler/setup'
+
+module Legion
+  module Logging
+    def self.debug(_msg); end
+    def self.info(_msg); end
+    def self.warn(_msg); end
+    def self.error(_msg); end
+  end
+end
+
+require 'legion/extensions/coldstart'
+
+RSpec.configure do |config|
+  config.example_status_persistence_file_path = '.rspec_status'
+  config.disable_monkey_patching!
+  config.expect_with(:rspec) { |c| c.syntax = :expect }
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: lex-coldstart
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Esity
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sequel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.70'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.70'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Imprint window and bootstrap calibration for brain-modeled agentic AI
+email:
+- matthewdiverson@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- lex-coldstart.gemspec
+- lib/legion/extensions/coldstart.rb
+- lib/legion/extensions/coldstart/actors/imprint.rb
+- lib/legion/extensions/coldstart/client.rb
+- lib/legion/extensions/coldstart/helpers/bootstrap.rb
+- lib/legion/extensions/coldstart/helpers/claude_parser.rb
+- lib/legion/extensions/coldstart/helpers/imprint.rb
+- lib/legion/extensions/coldstart/local_migrations/20260316000050_create_bootstrap_state.rb
+- lib/legion/extensions/coldstart/runners/coldstart.rb
+- lib/legion/extensions/coldstart/runners/ingest.rb
+- lib/legion/extensions/coldstart/version.rb
+- spec/fixtures/sample_claude.md
+- spec/fixtures/sample_memory.md
+- spec/legion/extensions/coldstart/actors/imprint_spec.rb
+- spec/legion/extensions/coldstart/client_spec.rb
+- spec/legion/extensions/coldstart/helpers/claude_parser_spec.rb
+- spec/legion/extensions/coldstart/runners/coldstart_spec.rb
+- spec/legion/extensions/coldstart/runners/ingest_spec.rb
+- spec/local_persistence_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/LegionIO/lex-coldstart
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/LegionIO/lex-coldstart
+  source_code_uri: https://github.com/LegionIO/lex-coldstart
+  documentation_uri: https://github.com/LegionIO/lex-coldstart
+  changelog_uri: https://github.com/LegionIO/lex-coldstart
+  bug_tracker_uri: https://github.com/LegionIO/lex-coldstart/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: LEX Coldstart
+test_files: []