claude_memory 0.8.0 → 0.9.1

data/lib/claude_memory/sweep/maintenance.rb

@@ -8,10 +8,16 @@ module ClaudeMemory
     #
     # Source: QMD v2.0.1 Maintenance class pattern
     class Maintenance
+      # Short / noise tokens dropped before Jaccard comparison.
+      # Intentionally minimal — we want conservative token extraction that
+      # still treats "Rails 8.0" and "Rails 8.1" as overlapping.
+      RESTORE_STOPWORDS = %w[for the and with via of in on to by is are].to_set.freeze
+      RESTORE_JACCARD_THRESHOLD = 0.5
       DEFAULT_CONFIG = {
         proposed_fact_ttl_days: 14,
         disputed_fact_ttl_days: 30,
-        content_retention_days: 30
+        content_retention_days: 30,
+        mcp_tool_call_retention_days: 90
       }.freeze
 
       attr_reader :store
@@ -96,6 +102,85 @@ module ClaudeMemory
         0
       end
 
+      # Restore superseded facts in a (subject, predicate) slot that were
+      # only superseded because of an obsolete single-value classification.
+      # Uses Jaccard-based token overlap to distinguish bug-superseded facts
+      # (token-disjoint siblings) from legitimate corrections (overlapping
+      # siblings).
+      #
+      # Refuses to run on predicates still classified as single-value — they
+      # should stay superseded by design.
+      #
+      # Never touches status: "rejected" facts (explicit user decisions).
+      #
+      # @return [Hash] {inspected, restored, skipped_ambiguous, skipped_rejected, decisions}
+      def restore_multi_value_supersessions(predicate:, dry_run: false)
+        if ClaudeMemory::Resolve::PredicatePolicy.single?(predicate)
+          raise ArgumentError, "Predicate '#{predicate}' is still classified single-value; refusing to restore"
+        end
+
+        result = {inspected: 0, restored: 0, skipped_ambiguous: 0, skipped_rejected: 0, decisions: []}
+
+        rows_by_subject = @store.facts
+          .where(predicate: predicate)
+          .exclude(status: "rejected")
+          .select(:id, :subject_entity_id, :object_literal, :status)
+          .all
+          .group_by { |r| r[:subject_entity_id] }
+
+        rejected_by_subject = @store.facts
+          .where(predicate: predicate, status: "rejected")
+          .select(:id, :subject_entity_id, :object_literal)
+          .all
+          .group_by { |r| r[:subject_entity_id] }
+
+        @store.db.transaction do
+          rows_by_subject.each do |subject_id, rows|
+            rejected_rows = rejected_by_subject[subject_id] || []
+            siblings = rows + rejected_rows
+
+            rows.each do |candidate|
+              next unless candidate[:status] == "superseded"
+              result[:inspected] += 1
+
+              candidate_tokens = restore_tokenize(candidate[:object_literal])
+              ambiguous_against = find_overlapping_siblings(candidate, siblings, candidate_tokens)
+
+              if ambiguous_against.empty?
+                result[:restored] += 1
+                result[:decisions] << {
+                  subject_entity_id: subject_id,
+                  fact_id: candidate[:id],
+                  object: candidate[:object_literal],
+                  action: :restore
+                }
+                restore_fact!(candidate[:id]) unless dry_run
+              else
+                result[:skipped_ambiguous] += 1
+                result[:decisions] << {
+                  subject_entity_id: subject_id,
+                  fact_id: candidate[:id],
+                  object: candidate[:object_literal],
+                  action: :skip_ambiguous,
+                  overlaps_with: ambiguous_against.map { |s| s[:object_literal] }
+                }
+              end
+            end
+          end
+        end
+
+        result
+      end
+
+      # Delete MCP tool-call telemetry rows older than retention window.
+      # Returns: Integer count of deleted rows (0 if table missing).
+      def prune_old_mcp_tool_calls
+        return 0 unless @store.db.table_exists?(:mcp_tool_calls)
+
+        cutoff = cutoff_time(@config[:mcp_tool_call_retention_days])
+        @store.mcp_tool_calls.where { called_at < cutoff }.delete
+      end
+
       # Checkpoint the SQLite WAL file for compaction.
       # Returns: true
       def checkpoint_wal
@@ -112,6 +197,35 @@ module ClaudeMemory
 
       private
 
+      def restore_tokenize(text)
+        return Set.new if text.nil?
+        text.downcase
+          .scan(/[a-z0-9]+/)
+          .reject { |t| t.length <= 2 || RESTORE_STOPWORDS.include?(t) }
+          .to_set
+      end
+
+      def restore_jaccard(a, b)
+        return 0.0 if a.empty? && b.empty?
+        intersection = (a & b).size
+        union = (a | b).size
+        return 0.0 if union.zero?
+        intersection.to_f / union
+      end
+
+      def find_overlapping_siblings(candidate, siblings, candidate_tokens)
+        siblings.select do |other|
+          next false if other[:id] == candidate[:id]
+          other_tokens = restore_tokenize(other[:object_literal])
+          restore_jaccard(candidate_tokens, other_tokens) >= RESTORE_JACCARD_THRESHOLD
+        end
+      end
+
+      def restore_fact!(fact_id)
+        @store.facts.where(id: fact_id).update(status: "active", valid_to: nil)
+        @store.fact_links.where(to_fact_id: fact_id, link_type: "supersedes").delete
+      end
+
       def cutoff_time(days)
         (Time.now - days * 86400).utc.iso8601
       end

data/lib/claude_memory/sweep/sweeper.rb

@@ -7,6 +7,7 @@ module ClaudeMemory
         proposed_fact_ttl_days: 14,
         disputed_fact_ttl_days: 30,
         content_retention_days: 30,
+        mcp_tool_call_retention_days: 90,
         default_budget_seconds: 5
       }.freeze
 
@@ -29,6 +30,7 @@ module ClaudeMemory
           disputed_facts_expired: 0,
           orphaned_provenance_deleted: 0,
           old_content_pruned: 0,
+          mcp_tool_calls_pruned: 0,
           escalation_level: :normal
         }
 
@@ -38,6 +40,7 @@ module ClaudeMemory
         run_if_within_budget { @stats[:disputed_facts_expired] = maintenance.expire_disputed_facts }
         run_if_within_budget { @stats[:orphaned_provenance_deleted] = maintenance.prune_orphaned_provenance }
         run_if_within_budget { @stats[:old_content_pruned] = maintenance.prune_old_content }
+        run_if_within_budget { @stats[:mcp_tool_calls_pruned] = maintenance.prune_old_mcp_tool_calls }
         run_if_within_budget { @stats[:vec_backfilled] = maintenance.backfill_vec_index }
         run_if_within_budget { @stats[:vec_cleaned] = maintenance.cleanup_vec_expired }
         run_if_within_budget { @stats[:wal_checkpointed] = maintenance.checkpoint_wal }

data/lib/claude_memory/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeMemory
-  VERSION = "0.8.0"
+  VERSION = "0.9.1"
 end

data/lib/claude_memory.rb

@@ -70,6 +70,9 @@ require_relative "claude_memory/commands/export_command"
 require_relative "claude_memory/commands/git_lfs_command"
 require_relative "claude_memory/commands/install_skill_command"
 require_relative "claude_memory/commands/completion_command"
+require_relative "claude_memory/commands/embeddings_command"
+require_relative "claude_memory/commands/reject_command"
+require_relative "claude_memory/commands/restore_command"
 require_relative "claude_memory/commands/registry"
 require_relative "claude_memory/cli"
 require_relative "claude_memory/configuration"
@@ -80,6 +83,8 @@ require_relative "claude_memory/domain/fact"
 require_relative "claude_memory/domain/entity"
 require_relative "claude_memory/domain/provenance"
 require_relative "claude_memory/domain/conflict"
+require_relative "claude_memory/embeddings/model_registry"
+require_relative "claude_memory/embeddings/inspector"
 require_relative "claude_memory/embeddings/generator"
 require_relative "claude_memory/embeddings/fastembed_adapter"
 require_relative "claude_memory/embeddings/api_adapter"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_memory
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Valentino Stoll
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.102'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.102'
 - !ruby/object:Gem::Dependency
   name: extralite
   requirement: !ruby/object:Gem::Requirement
@@ -44,6 +44,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.9
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -51,8 +54,13 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.1'
-description: Turn-key Ruby gem providing Claude Code with instant, high-quality, long-term,
-  self-managed memory using Claude Code Hooks + MCP + Output Style.
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.9
+description: Gives Claude Code persistent memory across sessions. Claude recalls your
+  codebase architecture without file traversal, enforces project conventions during
+  code generation, tracks decisions with rationale, and remembers your preferences
+  across all projects. Zero-config via Hooks + MCP.
 email:
 - v@codenamev.com
 executables:
@@ -64,11 +72,11 @@ files:
 - ".claude-plugin/commands/memory-recall.md"
 - ".claude-plugin/marketplace.json"
 - ".claude-plugin/plugin.json"
+- ".claude-plugin/scripts/hook-runner.sh"
+- ".claude-plugin/scripts/serve-mcp.sh"
 - ".claude.json"
 - ".claude/CLAUDE.md"
 - ".claude/memory.sqlite3"
-- ".claude/memory.sqlite3-shm"
-- ".claude/memory.sqlite3-wal"
 - ".claude/output-styles/memory-aware.md"
 - ".claude/rules/claude_memory.generated.md"
 - ".claude/settings.json"
@@ -81,6 +89,7 @@ files:
 - ".claude/skills/memory-first-workflow"
 - ".claude/skills/quality-update/SKILL.md"
 - ".claude/skills/quality-update/implementation-guide.md"
+- ".claude/skills/release/SKILL.md"
 - ".claude/skills/review-commit/SKILL.md"
 - ".claude/skills/review-for-quality/SKILL.md"
 - ".claude/skills/review-for-quality/expert-checklists.md"
@@ -88,6 +97,7 @@ files:
 - ".claude/skills/study-repo/SKILL.md"
 - ".claude/skills/study-repo/analysis-template.md"
 - ".claude/skills/study-repo/focus-examples.md"
+- ".claude/skills/upgrade-dependencies/SKILL.md"
 - ".gitattributes"
 - ".lefthook/map_specs.rb"
 - ".mcp.json"
@@ -114,6 +124,8 @@ files:
 - db/migrations/010_add_llm_cache.rb
 - db/migrations/011_add_tool_call_summaries.rb
 - db/migrations/012_add_vec_indexing_support.rb
+- db/migrations/013_add_mcp_tool_calls.rb
+- db/migrations/014_canonicalize_predicates.rb
 - docs/EXAMPLES.md
 - docs/GETTING_STARTED.md
 - docs/RELEASE_NOTES_v0.2.0.md
@@ -163,6 +175,7 @@ files:
 - lib/claude_memory/commands/conflicts_command.rb
 - lib/claude_memory/commands/db_init_command.rb
 - lib/claude_memory/commands/doctor_command.rb
+- lib/claude_memory/commands/embeddings_command.rb
 - lib/claude_memory/commands/explain_command.rb
 - lib/claude_memory/commands/export_command.rb
 - lib/claude_memory/commands/git_lfs_command.rb
@@ -183,6 +196,8 @@ files:
 - lib/claude_memory/commands/recall_command.rb
 - lib/claude_memory/commands/recover_command.rb
 - lib/claude_memory/commands/registry.rb
+- lib/claude_memory/commands/reject_command.rb
+- lib/claude_memory/commands/restore_command.rb
 - lib/claude_memory/commands/search_command.rb
 - lib/claude_memory/commands/serve_mcp_command.rb
 - lib/claude_memory/commands/skills/distill-transcripts.md
@@ -225,6 +240,8 @@ files:
 - lib/claude_memory/embeddings/dimension_check.rb
 - lib/claude_memory/embeddings/fastembed_adapter.rb
 - lib/claude_memory/embeddings/generator.rb
+- lib/claude_memory/embeddings/inspector.rb
+- lib/claude_memory/embeddings/model_registry.rb
 - lib/claude_memory/embeddings/resolver.rb
 - lib/claude_memory/embeddings/similarity.rb
 - lib/claude_memory/hook/context_injector.rb
@@ -262,6 +279,7 @@ files:
 - lib/claude_memory/mcp/response_formatter.rb
 - lib/claude_memory/mcp/server.rb
 - lib/claude_memory/mcp/setup_status_analyzer.rb
+- lib/claude_memory/mcp/telemetry.rb
 - lib/claude_memory/mcp/text_summary.rb
 - lib/claude_memory/mcp/tool_definitions.rb
 - lib/claude_memory/mcp/tool_helpers.rb
@@ -318,5 +336,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.6
 specification_version: 4
-summary: Long-term, self-managed memory for Claude Code
+summary: Long-term memory for Claude Code — architecture recall, convention enforcement,
+  decision tracking
 test_files: []