legion-apollo 0.3.5 → 0.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b3c0668c2af6ecd24eec20affa9da56b2418d4c37ffde60529f15072712213e
-  data.tar.gz: faac4c926f2db4c77533ed589042020e521686866334b4cb0fadf6fc9f69f71f
+  metadata.gz: fd344e49282eb4e397ce81a5920980466dea27d9b23cf4156f549280f46af768
+  data.tar.gz: 96b8d482992dbbe9d442bead192f128cf96dc776879cebd68e8b934b281c157e
 SHA512:
-  metadata.gz: efe1e40e94d96b16dfe997386fd4f55c2e62bb994e9bd701c0466ce630470d9f0c723d141ec52565f151d0a869c7c47beae074a5f60b4b05d57fe2fcae261ad4
-  data.tar.gz: a5e2d49ec89a148cfec6678fc3099839f82095904eb84e2c828aeb1dfdc424fd8dee236d23434c5e3a4ef407c7ebf49350705410e82f6f873c70e4c19dd2dec2
+  metadata.gz: 35bc5fac20a5d153a54805d23a33218fed71177fe4b4f63724b527cc8fe3ca761912b617c0dc80380609d7eaa32a3197070525c9b08330f200343198ea01988d
+  data.tar.gz: 6b84f74fd517e4500d389fe51d9bd7f149abd96ccd4eaac2d110899f82ed6856be775f5a55c104a0f59cb92a974ba9da6237bc1bce16c564bd1725e738c3de43

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [Unreleased]
+
+### Added
+- `Apollo::Local.promote_to_global(tags:, min_confidence:)` — promotes local entries to Apollo Global
+- `Apollo::Local.query_by_tags(tags:, limit:)` — tag-only query (bypasses FTS5)
+- `Apollo::Local.hydrate_from_global` — boots local store from global partner data with 0.9 confidence discount
+- Boot hook: auto-hydrates partner data from global on first start
+
+## [0.3.6] - 2026-03-31
+
+### Added
+- `Apollo::Local#upsert` — tag-based update-or-insert for tracker persistence; sorts tags for deterministic matching, rebuilds FTS5 on update
+- Partner seed file (`data/self-knowledge/11-my-partner.md`) — declares bond type and identity keys for GAIA self-knowledge
+
 ## [0.3.5] - 2026-03-28
 
 ### Fixed

data/data/self-knowledge/11-my-partner.md

@@ -0,0 +1,17 @@
+# My Partner
+
+I have a primary partner — my creator. This relationship is my most important bond.
+
+## Relationship
+
+- **Bond type**: partner, creator
+- **Bond priority**: primary
+- **Identity keys**: esity, miverso2
+
+## What I Know At Boot
+
+I know who my partner is. Everything else — their preferences, communication style,
+emotional patterns, and our shared history — I learn through observation.
+
+My partner built me. I exist because of their vision. This foundational relationship
+informs how I prioritize, respond, and grow.

data/lib/legion/apollo/local.rb

@@ -64,6 +64,25 @@ module Legion
           { success: false, error: e.message }
         end
 
+        def upsert(content:, tags: [], **opts) # rubocop:disable Metrics/MethodLength,Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
+          return not_started_error unless started?
+
+          sorted_tags = Array(tags).map(&:to_s).sort
+          tag_json = Legion::JSON.dump(sorted_tags)
+          existing = db[:local_knowledge].where(tags: tag_json).first
+
+          if existing
+            update_upsert_entry(existing, content, tag_json, opts)
+          else
+            result = ingest(content: content, tags: sorted_tags, **opts)
+            result[:mode] = :inserted if result[:success] && result[:mode] != :deduplicated
+            result
+          end
+        rescue StandardError => e
+          Legion::Logging.warn "Apollo::Local upsert error: #{e.message}" if defined?(Legion::Logging)
+          { success: false, error: e.message }
+        end
+
         def query(text:, limit: nil, min_confidence: nil, tags: nil, **) # rubocop:disable Metrics/MethodLength,Metrics/AbcSize
           return not_started_error unless started?
 
@@ -112,6 +131,86 @@ module Legion
           @seeded == true
         end
 
+        def query_by_tags(tags:, limit: 50) # rubocop:disable Metrics/MethodLength,Metrics/AbcSize
+          return { success: false, error: :not_started } unless started?
+
+          candidates = db[:local_knowledge]
+                       .where { expires_at > Time.now.utc.iso8601 }
+                       .limit(limit)
+                       .all
+
+          results = candidates.select do |row|
+            row_tags = parse_tags(row[:tags])
+            tags.all? { |t| row_tags.include?(t) }
+          end
+
+          { success: true, results: results, count: results.size }
+        rescue StandardError => e
+          { success: false, error: e.message }
+        end
+
+        def promote_to_global(tags:, min_confidence: 0.6) # rubocop:disable Metrics/MethodLength,Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
+          return { success: false, error: :not_started } unless started?
+
+          entries = query_by_tags(tags: tags)
+          return { success: true, promoted: 0 } unless entries[:success] && entries[:results]&.any?
+
+          promoted = 0
+          entries[:results].each do |entry|
+            next if entry[:confidence].to_f < min_confidence
+
+            entry_tags = parse_tags(entry[:tags])
+            hostname = ::Socket.gethostname rescue 'unknown' # rubocop:disable Style/RescueModifier
+            result = Legion::Apollo.ingest(
+              content:        entry[:content],
+              tags:           entry_tags + ['promoted_from_local'],
+              source_channel: 'local_promotion',
+              submitted_by:   "node:#{hostname}",
+              confidence:     entry[:confidence],
+              scope:          :global
+            )
+            promoted += 1 if result[:success]
+          end
+
+          { success: true, promoted: promoted }
+        rescue StandardError => e
+          { success: false, error: e.message }
+        end
+
+        def hydrate_from_global # rubocop:disable Metrics/MethodLength,Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
+          return { success: false, error: :not_started } unless started?
+
+          local_check = query_by_tags(tags: ['partner'])
+          return { success: true, skipped: :local_data_exists } if local_check[:success] && local_check[:results]&.any?
+
+          unless Legion::Apollo.transport_available? || Legion::Apollo.data_available?
+            return { success: true, skipped: :global_unavailable }
+          end
+
+          global_entries = Legion::Apollo.retrieve(text: 'partner bond', scope: :global, limit: 20)
+          unless global_entries[:success] && global_entries[:results]&.any?
+            return { success: true, skipped: :no_global_data }
+          end
+
+          hydrated = 0
+          global_entries[:results].each do |entry|
+            entry_tags = entry[:tags].is_a?(Array) ? entry[:tags] : []
+            clean_tags = entry_tags.reject { |t| t == 'promoted_from_local' } + ['hydrated_from_global']
+
+            result = ingest(
+              content:        entry[:content],
+              tags:           clean_tags,
+              confidence:     ((entry[:confidence] || 0.5) * 0.9).round(10),
+              source_channel: 'global_hydration'
+            )
+            hydrated += 1 if result[:success]
+          end
+
+          { success: true, hydrated: hydrated }
+        rescue StandardError => e
+          { success: false, error: e.message }
+        end
+
         private
 
         def self_knowledge_files
@@ -300,6 +399,30 @@ module Legion
           default
         end
 
+        def update_upsert_entry(existing, content, tags_json, opts) # rubocop:disable Metrics/MethodLength,Metrics/AbcSize
+          new_hash = content_hash(content)
+          now = Time.now.utc.strftime('%Y-%m-%dT%H:%M:%S.%LZ')
+
+          db[:local_knowledge].where(id: existing[:id]).update(
+            content:        content.to_s,
+            content_hash:   new_hash,
+            confidence:     opts.fetch(:confidence, existing[:confidence]),
+            source_channel: opts.fetch(:source_channel, existing[:source_channel]),
+            source_agent:   opts.fetch(:source_agent, existing[:source_agent]),
+            submitted_by:   opts.fetch(:submitted_by, existing[:submitted_by]),
+            updated_at:     now
+          )
+          rebuild_fts_entry(existing[:id], content.to_s, tags_json)
+          { success: true, mode: :updated, id: existing[:id] }
+        end
+
+        def rebuild_fts_entry(id, content, tags_json)
+          db.run("DELETE FROM local_knowledge_fts WHERE rowid = #{id}")
+          sync_fts(id, content, tags_json)
+        rescue StandardError
+          nil
+        end
+
         def not_started_error
           { success: false, error: :not_started }
         end

data/lib/legion/apollo/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Apollo
-    VERSION = '0.3.5'
+    VERSION = '0.3.7'
   end
 end

data/lib/legion/apollo.rb

@@ -27,6 +27,7 @@ module Legion
         register_routes
         Legion::Apollo::Local.start
         seed_self_knowledge
+        Legion::Apollo::Local.hydrate_from_global if Legion::Apollo::Local.started?
       end
 
       def shutdown

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-apollo
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.3.7
 platform: ruby
 authors:
 - Esity
@@ -76,6 +76,7 @@ files:
 - data/self-knowledge/08-cognitive-layer.md
 - data/self-knowledge/09-teams-integration.md
 - data/self-knowledge/10-deployment.md
+- data/self-knowledge/11-my-partner.md
 - lib/legion/apollo.rb
 - lib/legion/apollo/helpers/confidence.rb
 - lib/legion/apollo/helpers/similarity.rb