memoflow 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd44156c1785088292a9194c41d5ddec68b3ce93f34b9962671e4b6477ba8ddb
-  data.tar.gz: '08298b8f84586b763586fd1103a689b81b94eb35bdd6b4c29d9a0e4f5e4a9d01'
+  metadata.gz: '00489d24e9c215b49e98995ef01c58aa55d429af2ec5ed0dd9d5ac44a6b0e289'
+  data.tar.gz: 56b4fd3707959259d19224cac4a6cc61e70f2848b80ec4203ce8ddf6c141ac5e
 SHA512:
-  metadata.gz: 03415cb660077882ae968cee30771b00c5726cf2afdcbf563320cac52fa2e83d5660d20756b196dbf4c309a4658023941d38aa4fcfa3475d8cb58a488519bcf1
-  data.tar.gz: 28e69feac39e5ca51f58f7e264ed5a72da5f72a16c4403e2ffa2c8e60941a592752727714a0d1288b9b2ed149af3fc38ac4a161055342fc76356a3623fadce6d
+  metadata.gz: 53c8e0ebff351f2f33d4470dd1c0a223dc8655beda9bcc69079d25f9a6da2db47e9757e85c2a3f4103dcdc3ac70afe30bd0d55f8baa53177f1aff41d7a59d408
+  data.tar.gz: 46d14a0e697308e858c0812ed81ed9565cf3663a0143ee301ba33517503392e0628140171088e763c66e94efbee8b145bba57f0d6e4374989e6ee54e01b54068

data/README.md

@@ -29,6 +29,46 @@ end
 
 If you do not want a Rails initializer, the CLI can operate with `MEMOFLOW_KEY` alone.
 
+## Encryption key setup
+
+Memoflow encrypts stored context locally. `MEMOFLOW_KEY` is the secret used to encrypt and decrypt that repository's stored memory.
+
+Generate a strong key with either:
+
+```bash
+ruby -rsecurerandom -e 'puts SecureRandom.hex(32)'
+```
+
+or:
+
+```bash
+openssl rand -hex 32
+```
+
+Then export it in your shell:
+
+```bash
+export MEMOFLOW_KEY="paste-generated-key-here"
+```
+
+Why it should be project-specific:
+
+- it limits the blast radius if one key is exposed
+- it keeps one repository's history isolated from another
+- it lets teams share access only to the repos they should decrypt
+
+Recommended handling:
+
+- use one key per repository
+- store it in a password manager or team secret store
+- do not commit it to git
+- do not reuse production application secrets for Memoflow
+
+Important:
+
+- if you lose the key, existing Memoflow data for that repository cannot be decrypted
+- if your team needs shared access to the same stored context, everyone must use the same repo key
+
 Optional embedding provider:
 
 ```ruby
@@ -81,6 +121,12 @@ bundle exec memoflow annotate "Problem statement: fix webhook retries"
 bundle exec memoflow query "webhook retries"
 ```
 
+## Ruby compatibility
+
+Memoflow is currently targeted at Ruby `>= 2.3.0`.
+
+This support floor is chosen to work more cleanly with older Rails applications while avoiding newer Ruby-only core methods in the runtime code.
+
 Rails initializer example:
 
 ```ruby

data/lib/memoflow/client.rb

@@ -114,7 +114,8 @@ module Memoflow
     end
 
     def current_task_id
-      @store.read_state("current_task")&.dig(:task_id)
+      state = @store.read_state("current_task")
+      state ? state[:task_id] : nil
     end
 
     def query(term = nil, limit: 5)
@@ -173,8 +174,8 @@ module Memoflow
 
       tokens = term.downcase.split(/\s+/)
       fields = normalized_fields(entry)
-      score = tokens.sum do |token|
-        field_score(fields, token)
+      score = tokens.inject(0) do |total, token|
+        total + field_score(fields, token)
       end
 
       score + recency_boost(entry) + task_boost(entry) + semantic_boost(entry, term)

data/lib/memoflow/embedding_provider.rb

@@ -41,7 +41,7 @@ module Memoflow
     end
 
     def normalize(vector)
-      magnitude = Math.sqrt(vector.sum { |value| value * value })
+      magnitude = Math.sqrt(vector.inject(0.0) { |total, value| total + value * value })
       return vector if magnitude.zero?
 
       vector.map { |value| (value / magnitude).round(6) }

data/lib/memoflow/encryptor.rb

@@ -42,7 +42,7 @@ module Memoflow
     def unpack(blob)
       cursor = 0
       parts = 3.times.map do
-        length = blob.byteslice(cursor, 4).unpack1("N")
+        length = blob.byteslice(cursor, 4).unpack("N").first
         cursor += 4
         part = blob.byteslice(cursor, length)
         cursor += length

data/lib/memoflow/provider_context.rb

@@ -10,11 +10,11 @@ module Memoflow
     end
 
     def capture
-      {
+      compact_hash(
         provider: provider,
         repository: repository,
         pull_request: pull_request
-      }.compact
+      )
     end
 
     private
@@ -68,6 +68,10 @@ module Memoflow
       "#{parts[-2]}/#{parts[-1].sub(/\.git\z/, "")}"
     end
 
+    def compact_hash(hash)
+      hash.reject { |_, value| value.nil? }
+    end
+
     def source_text
       [@remote_url, @env["GITHUB_SERVER_URL"], @env["CI_SERVER_URL"]].compact.join(" ").downcase
     end

data/lib/memoflow/server.rb

@@ -21,11 +21,11 @@ module Memoflow
         rescue IOError, SystemCallError
           break unless @running
         ensure
-          socket&.close
+          socket.close if socket
         end
       end
     ensure
-      @server&.close
+      @server.close if @server
     end
 
     private
@@ -91,7 +91,7 @@ module Memoflow
       %w[INT TERM].each do |signal|
         trap(signal) do
           @running = false
-          @server&.close
+          @server.close if @server
         end
       end
     end

data/lib/memoflow/store.rb

@@ -120,7 +120,7 @@ module Memoflow
       with_lock do
         setup!
         path = @root.join(scope, filename)
-        payload = JSON.generate(envelope(record).transform_keys(&:to_s))
+        payload = JSON.generate(stringify_keys(envelope(record)))
         atomic_write(path, @encryptor.encrypt(payload))
       end
     end
@@ -170,9 +170,11 @@ module Memoflow
       setup!
       File.open(@root.join(".lock"), File::RDWR | File::CREAT, 0o644) do |file|
         file.flock(File::LOCK_EX)
-        yield
-      ensure
-        file.flock(File::LOCK_UN)
+        begin
+          yield
+        ensure
+          file.flock(File::LOCK_UN)
+        end
       end
     end
 
@@ -184,5 +186,13 @@ module Memoflow
     ensure
       File.delete(temp_path) if temp_path && File.exist?(temp_path)
     end
+
+    def stringify_keys(hash)
+      result = {}
+      hash.each do |key, value|
+        result[key.to_s] = value
+      end
+      result
+    end
   end
 end

data/lib/memoflow/vectorizer.rb

@@ -19,7 +19,9 @@ module Memoflow
         return 0.0 if left.nil? || right.nil?
         return 0.0 if left.empty? || right.empty?
 
-        left.zip(right).sum { |a, b| a.to_f * b.to_f }
+        left.zip(right).inject(0.0) do |total, pair|
+          total + pair[0].to_f * pair[1].to_f
+        end
       end
 
       def indexable_text(entry)
@@ -47,7 +49,7 @@ module Memoflow
       end
 
       def normalize(vector)
-        magnitude = Math.sqrt(vector.sum { |value| value * value })
+        magnitude = Math.sqrt(vector.inject(0.0) { |total, value| total + value * value })
         return vector if magnitude.zero?
 
         vector.map { |value| (value / magnitude).round(6) }

data/lib/memoflow/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Memoflow
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
   SCHEMA_VERSION = 1
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: memoflow
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Jayesh Pawar
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-26 00:00:00.000000000 Z
+date: 2026-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -51,12 +51,12 @@ files:
 - lib/memoflow/store.rb
 - lib/memoflow/vectorizer.rb
 - lib/memoflow/version.rb
-homepage: https://github.com/jayesh-ikshalabs/memoflow
+homepage: https://jayesh-ikshalabs.github.io/memoflow-docs/
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/jayesh-ikshalabs/memoflow
-  changelog_uri: https://github.com/jayesh-ikshalabs/memoflow/releases
+  source_code_uri: https://github.com/jayesh-ikshalabs/memoflow-docs
+  changelog_uri: https://jayesh-ikshalabs.github.io/memoflow-docs/#compatibility
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -65,7 +65,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="