llmemory 0.2.7 → 0.2.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ecc37d3f00fe0f347b1cf37d17665a84b92fa8a0effdf6f238178651f44f58a9
-  data.tar.gz: 35dc741e76e12814e6abae4ede8cace697802359892cbb9c419a5e224c5b16f9
+  metadata.gz: 1758a40a096cf694812a669cb4c92ee6010954b68f733acf8d31083cd8ccaf21
+  data.tar.gz: 9f7c8a4d63c2f71325ef6dc5134fa5895655e1d2fadfe93b64ebbcc2e68224f6
 SHA512:
-  metadata.gz: 7161647ed2bd7ac8b48a4695cd915fb26e80aee867238f8b40a70d8d2b014af72f3206c0b738738d2429a17760927b486e101ce3e82dae09efa59469bb8b54c8
-  data.tar.gz: 310bc288d0e6570280dfd78cfe8f002bb2e071275baf47521649ab2ba56d40ce182cdce2b93cc0bc21ba3c2ccebce7122c4e99c4e481a004790fb030634f1a43
+  metadata.gz: f8ef12d0d2294ebc7eca0d1ad4760f92c288fb54c02c41ce88b88c16d8fd459d77364ab3f29388801daaaf4cf1c42d4e972dacfbda69c8433c13dc7ff4f4e5c0
+  data.tar.gz: 7b6bbe90b6b251f11cbc2692eb4f63d3dc57699dbadda16001d171b836a28fd4ac871e1e94742e81bd2b80efff890c13142934c7a210dee790331bad78ef1c37

data/lib/llmemory/railtie.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Llmemory
+  class Railtie < ::Rails::Railtie
+    rake_tasks do
+      load File.expand_path("../tasks/llmemory.rake", __dir__)
+    end
+  end
+end

data/lib/llmemory/vector_store/active_record_store.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "base"
-require_relative "../../active_record_helpers"
+require_relative "../active_record_helpers"
 
 module Llmemory
   module VectorStore

data/lib/llmemory/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Llmemory
-  VERSION = "0.2.7"
+  VERSION = "0.2.9"
 end

data/lib/llmemory.rb

@@ -28,3 +28,4 @@ module Llmemory
 end
 
 require_relative "llmemory/crypto/cipher"
+require_relative "llmemory/railtie" if defined?(Rails::Railtie)

data/lib/tasks/llmemory.rake

@@ -3,7 +3,9 @@
 namespace :llmemory do
   desc "Backfill search_tokens blind index (and name_det on skills) for encrypted keyword search. " \
        "Env: FORCE=1 (re-backfill all rows), DRY_RUN=1 (count only), STORE=active_record|postgres"
-  task :backfill_search_tokens, [:user_id] do |_t, args|
+  task_deps = Rake::Task.task_defined?(:environment) ? [:environment] : []
+
+  task :backfill_search_tokens, [:user_id] => task_deps do |_t, args|
     require "llmemory"
     require_relative "../llmemory/maintenance/search_tokens_backfill"
 

data/lib/tasks/release.rake

@@ -1,22 +1,86 @@
 # frozen_string_literal: true
 
+module Release
+  RELEASE_FILES = %w[lib/llmemory/version.rb Gemfile.lock CHANGELOG.txt].freeze
+  DEFAULT_NOTES_PATH = File.expand_path("../../tmp/release_notes.txt", __dir__)
+
+  module_function
+
+  def resolve_notes_path(arg)
+    path = arg.to_s.strip
+    path = DEFAULT_NOTES_PATH if path.empty?
+    File.expand_path(path)
+  end
+
+  def build_changelog_entry(version, date, notes_body)
+    body = notes_body.strip
+    body = body.sub(/\A#+\s*[^\n]*\n+/, "") # drop optional leading markdown title
+
+    <<~ENTRY
+
+      ## [#{version}] - #{date}
+
+      #{body}
+    ENTRY
+  end
+
+  def allowed_dirty_path?(path, notes_path)
+    RELEASE_FILES.include?(path) || File.expand_path(path) == File.expand_path(notes_path)
+  end
+end
+
 namespace :release do
-  desc "Bump version (patch|minor|major). Checks: branch=main, no uncommitted changes, tests pass. Then: Gemfile.lock, CHANGELOG, commit, push, tag"
-  task :bump, [:bump_type] => [] do |_t, args|
+  desc "Show commits and diff stat since the last tag (helper before writing release notes)"
+  task :since_tag do
+    last_tag = `git describe --tags --abbrev=0 2>/dev/null`.strip
+    range = last_tag.empty? ? "HEAD" : "#{last_tag}..HEAD"
+    puts "Last tag: #{last_tag.empty? ? '(none)' : last_tag}"
+    puts "Range: #{range}\n\n"
+    puts "Commits:"
+    puts(`git log #{range} --oneline`.strip)
+    puts "\nDiff stat:"
+    puts(`git diff #{range} --stat`.strip)
+  end
+
+  desc "Bump version (patch|minor|major). Requires tmp/release_notes.txt or notes path. Checks: branch=main, clean tree, tests pass. Then: version, CHANGELOG, commit, push, tag"
+  task :bump, [:bump_type, :notes_file] => [] do |_t, args|
     require_relative "../llmemory/version"
 
-    # Pre-flight checks
     current_branch = `git rev-parse --abbrev-ref HEAD`.strip
     abort "Current branch must be main (got: #{current_branch})" unless current_branch == "main"
 
-    # Allow only release-related files to be modified (we'll commit them)
-    release_files = %w[lib/llmemory/version.rb Gemfile.lock CHANGELOG.txt]
-    status_lines = `git status --porcelain`.strip.lines
+    notes_path = Release.resolve_notes_path(args[:notes_file])
+
+    status_lines = `git status --porcelain --untracked-files=normal`.strip.lines
     other_changes = status_lines.reject do |line|
-      path = line.sub(/\A..\s+/, "").strip
-      release_files.include?(path)
+      path = line.sub(/\A..\s+/, "").strip.split(" -> ").last
+      Release.allowed_dirty_path?(path, notes_path)
+    end
+    unless other_changes.empty?
+      abort "Working tree has uncommitted changes outside release files. Commit or stash them first.\n#{other_changes.join}"
+    end
+
+    unless File.exist?(notes_path)
+      abort <<~MSG
+        Release notes file not found: #{notes_path}
+
+        1. Inspect changes since the last tag:
+             bundle exec rake release:since_tag
+
+        2. Write a changelog entry (user-visible changes, not raw commits) to:
+             tmp/release_notes.txt
+
+           Use sections such as Added / Changed / Fixed / Removed / Notes.
+           Follow the style of recent entries in CHANGELOG.txt (e.g. v0.2.7).
+
+        3. Re-run:
+             bundle exec rake release:bump[#{args[:bump_type] || 'patch'}]
+             bundle exec rake release:bump[#{args[:bump_type] || 'patch'},path/to/notes.txt]
+      MSG
     end
-    abort "Working tree has uncommitted changes outside release files. Commit or stash them first." unless other_changes.empty?
+
+    notes_body = File.read(notes_path).strip
+    abort "Release notes file is empty: #{notes_path}" if notes_body.empty?
 
     puts "Running tests..."
     sh "bundle exec rspec"
@@ -36,41 +100,21 @@ namespace :release do
     new_version_s = new_version.to_s
 
     puts "Bumping #{Llmemory::VERSION} -> #{new_version_s} (#{bump_type})"
+    puts "  Release notes: #{notes_path}"
 
-    # 1. Update version.rb
     version_file = File.expand_path("../llmemory/version.rb", __dir__)
     content = File.read(version_file)
     content = content.sub(/VERSION = "[^"]+"/, %(VERSION = "#{new_version_s}"))
     File.write(version_file, content)
     puts "  Updated lib/llmemory/version.rb"
 
-    # 2. bundle install
     sh "bundle install"
     puts "  Updated Gemfile.lock"
 
-    # 3. Update CHANGELOG.txt
     changelog_path = File.expand_path("../../CHANGELOG.txt", __dir__)
-    changelog_content = if File.exist?(changelog_path)
-      File.read(changelog_path)
-    else
-      ""
-    end
-
+    changelog_content = File.exist?(changelog_path) ? File.read(changelog_path) : ""
     today = Time.now.strftime("%Y-%m-%d")
-    last_tag = `git describe --tags --abbrev=0 2>/dev/null`.strip
-    commits = if last_tag.empty?
-      `git log --oneline`.strip
-    else
-      `git log #{last_tag}..HEAD --oneline`.strip
-    end
-
-    new_entry = <<~CHANGELOG
-
-      ## [#{new_version_s}] - #{today}
-
-      ### Changes
-      #{commits.lines.map { |l| "- #{l.strip}" }.join("\n")}
-    CHANGELOG
+    new_entry = Release.build_changelog_entry(new_version_s, today, notes_body)
 
     header = "# Changelog\n\n"
     if changelog_content.empty?
@@ -82,19 +126,14 @@ namespace :release do
     File.write(changelog_path, changelog_content)
     puts "  Updated CHANGELOG.txt"
 
-    # 4. Commit
     sh "git add lib/llmemory/version.rb Gemfile.lock CHANGELOG.txt"
     sh "git commit -m 'Release v#{new_version_s}'"
-
-    # 5. Push
     sh "git push"
-
-    # 6. Tag
     sh "git tag v#{new_version_s}"
-
-    # 7. Push tag
     sh "git push origin v#{new_version_s}"
 
+    default_notes = Release::DEFAULT_NOTES_PATH
+    File.delete(notes_path) if File.expand_path(notes_path) == File.expand_path(default_notes) && File.exist?(notes_path)
     puts "\nDone. Released v#{new_version_s}"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llmemory
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.9
 platform: ruby
 authors:
 - llmemory
@@ -246,6 +246,7 @@ files:
 - lib/llmemory/memory_module.rb
 - lib/llmemory/noise_filter.rb
 - lib/llmemory/provenance.rb
+- lib/llmemory/railtie.rb
 - lib/llmemory/reflection.rb
 - lib/llmemory/reflection/reflector.rb
 - lib/llmemory/retrieval.rb