memoflow 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7b740677dd782355d12ca87b5841fc9d2060246053a7fd6bafdee8ef48430e9
-  data.tar.gz: 2ec2c7c8827235e89eb4908e2494044c6a6badc11b05ccb70a60cfa6dd363039
+  metadata.gz: 5385f8cb2a8ce3914a816df59159162dd0791f6a21700190572714e0a7ac31be
+  data.tar.gz: 04b002ac7647a4cb790319be0b00e9ddc19ff865728f4daca202547742ed0b14
 SHA512:
-  metadata.gz: c265d8d249762b5887fa3c58ac96e7a5f047c3d039920accbe2977df60fa8489a421856a529c49612a93cbf2631b38760eed328d4d543e68ea5f31c668818e99
-  data.tar.gz: bed11e21bfea20fd6e9c54b36762a3d9a3cf1538cadc3b27e0f35d7405a7cce92260d803d0850a2875d186bb5822622b63d3d49d77af74e39bb2f47ca87f1061
+  metadata.gz: d037263c24b7fff449a32b380e11a3d882e67d2b8bc1280428bdf18bdf8e362b1f78e3dd01256392fdcc054c12da0f8425b518ea37a9e9aeeb6213e84c8f5432
+  data.tar.gz: 4120c688872a8c391a65d4c1e948fa4b653ab94e2e88d45e7da5ef90057d912069d785f219dfac518b342d0a0900336e9fc7738e584db26da5d20bf9f9c3504e

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/cli.rb

@@ -76,7 +76,8 @@ module Memoflow
           puts JSON.pretty_generate(client.start_task(title))
         when "finish"
           id = argv.shift
-          puts JSON.pretty_generate(client.finish_task(id))
+          result = id.to_s.empty? ? client.finish_task : client.finish_task(id)
+          puts JSON.pretty_generate(result)
         when "resume"
           id = argv.shift
           raise Error, "task id is required" if id.to_s.empty?

data/lib/memoflow/client.rb

@@ -74,7 +74,8 @@ module Memoflow
       task.merge(current_session_id: session[:id])
     end
 
-    def finish_task(task_id = current_task_id, status: "completed")
+    def finish_task(task_id = nil, status: "completed")
+      task_id ||= current_task_id
       raise Error, "no active task" unless task_id
 
       task = find_task(task_id)
@@ -113,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)
@@ -172,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.1"
+  VERSION = "0.1.3"
   SCHEMA_VERSION = 1
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: memoflow
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Jayesh Pawar
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-25 00:00:00.000000000 Z
+date: 2026-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -27,7 +27,7 @@ dependencies:
 description: Memoflow captures git-backed development context and exposes a lightweight
   query API for AI assistants.
 email:
-- opensource@ikshalabs.com
+- jayesh.pawar@ikshalabs.com
 executables:
 - memoflow
 extensions: []
@@ -51,12 +51,12 @@ files:
 - lib/memoflow/store.rb
 - lib/memoflow/vectorizer.rb
 - lib/memoflow/version.rb
-homepage: https://github.com/ikshalabs/memoflow
+homepage: https://github.com/jayesh-ikshalabs/memoflow
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/ikshalabs/memoflow
-  changelog_uri: https://github.com/ikshalabs/memoflow/releases
+  source_code_uri: https://github.com/jayesh-ikshalabs/memoflow
+  changelog_uri: https://github.com/jayesh-ikshalabs/memoflow/releases
 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:
   - - ">="