swarm_memory 2.2.3 → 2.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6217058c4241029650e057e4f28c75eb1c6105f797657eb7c039eb307fe9bcab
-  data.tar.gz: a9f5d039fe4dd776dff184fce3a539bf40e3bfe9f150698b26847e2953bc5e46
+  metadata.gz: 768a8a8cd1d0ab5a3edff5e6e0c54e3fdce1e6c6af281d6a39285019167b87c8
+  data.tar.gz: aa9e396d3c72e53bf49459828c635148205c523e6d16bb42e7f6e4e5856a1d4c
 SHA512:
-  metadata.gz: 883afdf0f09de8425226e1ef1138b9f657de2a92b9efbb2b2262315479c3bc2a83542151a73d484ee632d6e5e5921e1f2232d7361d6c55457d530d982569e681
-  data.tar.gz: 963e4ba618cde5bdeb496815044b9c791fb68c9fb28f7543fcba75d93f77d095638d05417338132143b57dc0c6b845b7fad4f8853b433b845545272c36aa2e37
+  metadata.gz: c35aad639f910180b0bcd73db10b8db18f4cb9bde3d136789e77b26ac1a1a2a66fc476b1cce9731bf06566ad8bf9bfbc8edfe0c513b62a303c79346c6efb5b52
+  data.tar.gz: 18f0c1c5fc97d2946174e43d61c86493cbaa31626a8c6ecbf019ad12ca9654ebdeb77475305a79fb1c11ed85eb85b35be44fad349bb56806e039ea6afafea247

data/lib/swarm_memory/tools/memory_glob.rb

@@ -138,7 +138,7 @@ module SwarmMemory
         result << "Memory entries matching '#{pattern}' (#{entries.size} #{entries.size == 1 ? "entry" : "entries"}):"
 
         entries.each do |entry|
-          result << "  memory://#{entry[:path]} - \"#{entry[:title]}\" (#{format_bytes(entry[:size])})"
+          result << "- memory://#{entry[:path]} \"#{entry[:title]}\" (#{format_bytes(entry[:size])})"
         end
 
         output = result.join("\n")

data/lib/swarm_memory/tools/memory_grep.rb

@@ -7,6 +7,8 @@ module SwarmMemory
     # Searches content stored in memory entries using regex patterns.
     # Each agent has its own isolated memory storage.
     class MemoryGrep < RubyLLM::Tool
+      include TitleLookup
+
       description <<~DESC
         Search your memory content using regular expression patterns (like grep).
 
@@ -197,7 +199,7 @@ module SwarmMemory
         result = []
         result << "Memory entries matching #{search_desc} (#{paths.size} #{paths.size == 1 ? "entry" : "entries"}):"
         paths.each do |path|
-          result << "  memory://#{path}"
+          result << "- #{format_memory_path_with_title(path)}"
         end
         result.join("\n")
       end

data/lib/swarm_memory/tools/memory_read.rb

@@ -7,8 +7,10 @@ module SwarmMemory
     # Retrieves content stored by this agent using memory_write.
     # Each agent has its own isolated memory storage.
     class MemoryRead < RubyLLM::Tool
+      include TitleLookup
+
       description <<~DESC
-        Read content from your memory storage and retrieve all associated metadata.
+        Read content from your memory storage.
 
         REQUIRED: Provide the file_path parameter - the path to the memory entry you want to read.
 
@@ -25,9 +27,8 @@ module SwarmMemory
         INVALID: documentation/, reference/, tutorial/, parallel/, analysis/, notes/
 
         **Returns:**
-        JSON with two fields:
-        - content: Markdown content with line numbers (same format as Read tool)
-        - metadata: All metadata (title, type, tags, tools, permissions, confidence, etc.)
+        Markdown content with line numbers (same format as 'cat -n').
+        If the entry has related memories, a system-reminder section is appended listing them.
 
         **Examples:**
         - MemoryRead(file_path: "concept/ruby/classes.md") - Read a concept
@@ -38,6 +39,7 @@ module SwarmMemory
         - Always read entries before editing them with MemoryEdit
         - Line numbers in output are for reference only - don't include them when editing
         - Each read is tracked to enforce read-before-edit patterns
+        - Related memories in the system-reminder can be read with MemoryRead for additional context
       DESC
 
       param :file_path,
@@ -62,7 +64,7 @@ module SwarmMemory
       # Execute the tool
       #
       # @param file_path [String] Path to read from
-      # @return [String] JSON with content and metadata
+      # @return [String] Content with line numbers and optional related memories reminder
       def execute(file_path:)
         # Read full entry with metadata
         entry = @storage.read_entry(file_path: file_path)
@@ -70,8 +72,14 @@ module SwarmMemory
         # Register this read in the tracker with content digest
         Core::StorageReadTracker.register_read(@agent_name, file_path, entry.content)
 
-        # Always return JSON format (metadata always exists - at minimum title)
-        format_as_json(entry)
+        # Return plain text with line numbers
+        result = format_with_line_numbers(entry.content)
+
+        # Append related memories reminder if present
+        related_paths = entry.metadata&.dig("related") || []
+        result += format_related_memories_reminder(related_paths) if related_paths.any?
+
+        result
       rescue ArgumentError => e
         validation_error(e.message)
       end
@@ -82,29 +90,6 @@ module SwarmMemory
         "<tool_use_error>InputValidationError: #{message}</tool_use_error>"
       end
 
-      # Format entry as JSON with content and metadata
-      #
-      # Returns a clean JSON format separating content from metadata.
-      # This prevents agents from mimicking metadata format when writing.
-      #
-      # Content includes line numbers (same format as Read tool).
-      # Metadata always includes at least title (from Entry).
-      # Additional metadata comes from the metadata hash (type, tags, tools, etc.)
-      #
-      # @param entry [Core::Entry] Entry with content and metadata
-      # @return [String] Pretty-printed JSON
-      def format_as_json(entry)
-        # Build metadata hash with title included
-        metadata_hash = { "title" => entry.title }
-        metadata_hash.merge!(entry.metadata) if entry.metadata
-
-        result = {
-          content: format_with_line_numbers(entry.content),
-          metadata: metadata_hash,
-        }
-        JSON.pretty_generate(result)
-      end
-
       # Format content with line numbers (same format as Read tool)
       #
       # @param content [String] Content to format
@@ -114,10 +99,29 @@ module SwarmMemory
         output_lines = lines.each_with_index.map do |line, idx|
           line_number = idx + 1
           display_line = line.chomp
-          "#{line_number.to_s.rjust(6)}→#{display_line}"
+          "#{line_number.to_s.rjust(6)} #{display_line}"
         end
         output_lines.join("\n")
       end
+
+      # Format related memories as a system-reminder section
+      #
+      # Looks up titles for each related memory path and formats
+      # them as a system reminder to help agents discover related content.
+      #
+      # @param related_paths [Array<String>] Array of memory paths (with or without memory:// prefix)
+      # @return [String] Formatted system-reminder section
+      def format_related_memories_reminder(related_paths)
+        lines = ["\n\n<system-reminder>"]
+        lines << "Related memories that may provide additional context:"
+
+        related_paths.each do |path|
+          lines << "- #{format_memory_path_with_title(path)}"
+        end
+
+        lines << "</system-reminder>"
+        lines.join("\n")
+      end
     end
   end
 end

data/lib/swarm_memory/tools/title_lookup.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module SwarmMemory
+  module Tools
+    # Shared module for looking up memory entry titles
+    #
+    # Provides a consistent way to look up titles for memory entries
+    # across different tools (MemoryRead, MemoryGrep, etc.)
+    #
+    # @example Including in a tool
+    #   class MemoryGrep < RubyLLM::Tool
+    #     include TitleLookup
+    #
+    #     def some_method
+    #       title = lookup_title("concept/ruby/classes.md")
+    #     end
+    #   end
+    module TitleLookup
+      # Look up the title of a memory entry
+      #
+      # @param path [String] Path to the memory entry
+      # @return [String, nil] Title if found, nil otherwise
+      #
+      # @example
+      #   title = lookup_title("concept/ruby/classes.md")
+      #   # => "Ruby Classes"
+      def lookup_title(path)
+        entry = @storage.read_entry(file_path: path)
+        entry.title
+      rescue StandardError
+        nil
+      end
+
+      # Format a memory path with its title
+      #
+      # Normalizes the path (removes memory:// prefix if present) and
+      # formats it with the title in quotes if available.
+      #
+      # @param path [String] Path to the memory entry (with or without memory:// prefix)
+      # @return [String] Formatted string like 'memory://path "Title"' or 'memory://path'
+      #
+      # @example With title found
+      #   format_memory_path_with_title("concept/ruby/classes.md")
+      #   # => 'memory://concept/ruby/classes.md "Ruby Classes"'
+      #
+      # @example With memory:// prefix
+      #   format_memory_path_with_title("memory://concept/ruby/classes.md")
+      #   # => 'memory://concept/ruby/classes.md "Ruby Classes"'
+      #
+      # @example When title not found
+      #   format_memory_path_with_title("nonexistent.md")
+      #   # => 'memory://nonexistent.md'
+      def format_memory_path_with_title(path)
+        normalized_path = path.sub(%r{^memory://}, "")
+        title = lookup_title(normalized_path)
+
+        if title
+          "memory://#{normalized_path} \"#{title}\""
+        else
+          "memory://#{normalized_path}"
+        end
+      end
+    end
+  end
+end

data/lib/swarm_memory/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SwarmMemory
-  VERSION = "2.2.3"
+  VERSION = "2.2.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: swarm_memory
 version: !ruby/object:Gem::Version
-  version: 2.2.3
+  version: 2.2.4
 platform: ruby
 authors:
 - Paulo Arruda
@@ -71,14 +71,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.5.1
+        version: 2.5.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.5.1
+        version: 2.5.2
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -140,14 +140,15 @@ files:
 - lib/swarm_memory/tools/memory_grep.rb
 - lib/swarm_memory/tools/memory_read.rb
 - lib/swarm_memory/tools/memory_write.rb
+- lib/swarm_memory/tools/title_lookup.rb
 - lib/swarm_memory/utils.rb
 - lib/swarm_memory/version.rb
-homepage: https://github.com/parruda/claude-swarm
+homepage: https://github.com/parruda/swarm
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/parruda/claude-swarm
-  changelog_uri: https://github.com/parruda/claude-swarm/blob/main/docs/v2/CHANGELOG.swarm_memory.md
+  source_code_uri: https://github.com/parruda/swarm
+  changelog_uri: https://github.com/parruda/swarm/blob/main/docs/v2/CHANGELOG.swarm_memory.md
 rdoc_options: []
 require_paths:
 - lib