rails-ai-context 4.3.0 → 4.3.2

data/lib/rails_ai_context/tools/session_context.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module RailsAiContext
+  module Tools
+    class SessionContext < BaseTool
+      tool_name "rails_session_context"
+      description "Track what you've already queried to avoid redundant calls. " \
+        "Use action:\"status\" to see what tools you've called, action:\"summary\" for a compressed recap, " \
+        "action:\"reset\" to clear session, or mark:\"tool:param\" to record a query. " \
+        "Helps maintain focus during long development sessions."
+
+      input_schema(
+        properties: {
+          action: {
+            type: "string",
+            enum: %w[status summary reset],
+            description: "status: list queried tools with timestamps. summary: compressed recap. reset: clear session."
+          },
+          mark: {
+            type: "string",
+            description: "Mark a tool+params as already queried (e.g., 'get_schema:users', 'get_model_details:User')."
+          }
+        }
+      )
+
+      annotations(read_only_hint: true, destructive_hint: false, idempotent_hint: false, open_world_hint: false)
+
+      def self.call(action: nil, mark: nil, server_context: nil)
+        unless action || mark
+          return text_response("Provide `action` (status/summary/reset) or `mark` (tool:param to record).")
+        end
+
+        if mark
+          tool, params = parse_mark(mark)
+          session_record(tool, params)
+          return text_response("Marked `#{tool}` with params `#{params}` as queried.")
+        end
+
+        case action
+        when "status"
+          render_status
+        when "summary"
+          render_summary
+        when "reset"
+          session_reset!
+          text_response("Session cleared. All query records removed.")
+        else
+          text_response("Unknown action: #{action}. Use status, summary, or reset.")
+        end
+      rescue => e
+        text_response("Session context error: #{e.message}")
+      end
+
+      class << self
+        private
+
+        def parse_mark(mark_string)
+          parts = mark_string.split(":", 2)
+          tool = parts[0]&.strip
+          params = parts[1]&.strip || ""
+          [ tool, params ]
+        end
+
+        def render_status
+          queries = session_queries
+          if queries.empty?
+            return text_response("# Session Context\n\nNo queries recorded yet. Tools will be tracked as you use them.\n\n_Use `mark:\"tool:params\"` to manually record a query._\n_Note: CLI (`rails ai:tool`) runs each call in a separate process — session tracking only works via MCP._")
+          end
+
+          lines = [ "# Session Context (#{queries.size} queries)", "" ]
+          lines << "| Tool | Params | When |"
+          lines << "|------|--------|------|"
+
+          queries.sort_by { |q| q[:timestamp] }.each do |q|
+            ago = time_ago(q[:last_timestamp] || q[:timestamp])
+            params_str = q[:params].is_a?(Hash) ? q[:params].map { |k, v| "#{k}:#{v}" }.join(", ") : q[:params].to_s
+            params_display = params_str.empty? ? "-" : params_str.truncate(40)
+            count = q[:call_count] || 1
+            count_display = count > 1 ? " (#{count}x)" : ""
+            lines << "| `#{q[:tool]}`#{count_display} | #{params_display} | #{ago} |"
+          end
+
+          lines << ""
+          lines << "_Use `action:\"reset\"` to clear, or `action:\"summary\"` for a compressed recap._"
+          lines << "_Note: CLI (`rails ai:tool`) runs each call in a separate process — session tracking only works via MCP._"
+          text_response(lines.join("\n"))
+        end
+
+        def render_summary
+          queries = session_queries
+          if queries.empty?
+            return text_response("No queries recorded yet.")
+          end
+
+          total_calls = queries.sum { |q| q[:call_count] || 1 }
+          unique_tools = queries.map { |q| q[:tool] }.uniq.size
+          lines = [ "# Session Summary", "" ]
+          lines << "You have made #{total_calls} tool call(s) across #{unique_tools} unique tool(s) in this session:"
+          lines << ""
+
+          # Group by tool name, summing actual call counts
+          by_tool = queries.group_by { |q| q[:tool] }
+          by_tool.each do |tool, entries|
+            total_calls = entries.sum { |e| e[:call_count] || 1 }
+            params_list = entries.map { |c|
+              p = c[:params]
+              p.is_a?(Hash) ? p.map { |k, v| "#{k}:#{v}" }.join(", ") : p.to_s
+            }.reject(&:empty?)
+
+            if params_list.any?
+              lines << "- **#{tool}** (#{total_calls}x): #{params_list.uniq.join('; ')}"
+            else
+              lines << "- **#{tool}** (#{total_calls}x)"
+            end
+          end
+
+          lines << ""
+          lines << "_Avoid re-querying these. Use `action:\"status\"` for timestamps._"
+          text_response(lines.join("\n"))
+        end
+
+        def time_ago(iso_timestamp)
+          diff = Time.now - Time.parse(iso_timestamp)
+          if diff < 60
+            "#{diff.to_i}s ago"
+          elsif diff < 3600
+            "#{(diff / 60).to_i}m ago"
+          else
+            "#{(diff / 3600).to_i}h ago"
+          end
+        rescue
+          iso_timestamp
+        end
+      end
+    end
+  end
+end

data/lib/rails_ai_context/tools/validate.rb

@@ -48,6 +48,11 @@ module RailsAiContext
         total = 0
 
         files.each do |file|
+          if file.nil? || file.strip.empty?
+            results << "- (empty) \u2014 skipped (empty filename)"
+            next
+          end
+
           full_path = Rails.root.join(file)
 
           unless File.exist?(full_path)

data/lib/rails_ai_context/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsAiContext
-  VERSION = "4.3.0"
+  VERSION = "4.3.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-ai-context
 version: !ruby/object:Gem::Version
-  version: 4.3.0
+  version: 4.3.2
 platform: ruby
 authors:
 - crisnahine
@@ -170,7 +170,7 @@ dependencies:
 description: |
   rails-ai-context gives AI coding agents a complete mental model of your Rails
   app — not just files, but how schema, models, routes, controllers, views, and
-  conventions connect. 37 live tools (via MCP server or CLI) let agents query
+  conventions connect. 39 live tools (via MCP server or CLI) let agents query
   structure on demand with semantic validation that catches cross-file errors
   (wrong columns, missing partials, broken routes) before code runs.
   Auto-generates context files for Claude Code, Cursor, GitHub Copilot, and
@@ -293,9 +293,11 @@ files:
 - lib/rails_ai_context/tools/query.rb
 - lib/rails_ai_context/tools/read_logs.rb
 - lib/rails_ai_context/tools/review_changes.rb
+- lib/rails_ai_context/tools/runtime_info.rb
 - lib/rails_ai_context/tools/search_code.rb
 - lib/rails_ai_context/tools/search_docs.rb
 - lib/rails_ai_context/tools/security_scan.rb
+- lib/rails_ai_context/tools/session_context.rb
 - lib/rails_ai_context/tools/validate.rb
 - lib/rails_ai_context/version.rb
 - lib/rails_ai_context/watcher.rb
@@ -315,7 +317,7 @@ post_install_message: |
   rails-ai-context installed! Quick start:
     rails generate rails_ai_context:install
     rails ai:context              # generate context files
-    rails 'ai:tool[schema]'      # run any of the 37 tools from CLI
+    rails 'ai:tool[schema]'      # run any of the 39 tools from CLI
     rails ai:serve                # start MCP server (optional)
 rdoc_options: []
 require_paths:
@@ -333,6 +335,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Give AI agents a complete mental model of your Rails app — 37 tools via MCP
+summary: Give AI agents a complete mental model of your Rails app — 39 tools via MCP
   or CLI. Zero config.
 test_files: []