solid_loop 0.0.4

data/lib/tasks/coverage.rake

@@ -0,0 +1,206 @@
+require "json"
+
+namespace :coverage do
+  GROUPS = %w[
+    app/controllers app/models app/services app/helpers
+    app/jobs app/mailers app/queries app/channels
+    app/concerns app/views
+  ].freeze
+
+  desc "Parse coverage/coverage.json and print summary. Args: sort (worst|partial|uncovered|full), filter, git (staged|head|branch)"
+  task :report, [:sort, :filter, :git] do |_t, args|
+    CoverageReporter.report(args)
+  end
+
+  class CoverageReporter
+    COVERAGE_PATH = File.expand_path("../../coverage/coverage.json", __dir__)
+
+    def self.report(args)
+      new(args).report
+    end
+
+    def initialize(args)
+      @args = args
+    end
+
+    def report
+      unless File.exist?(COVERAGE_PATH)
+        abort "coverage/coverage.json not found. Run tests first:\n  bundle exec rspec"
+      end
+
+      data = JSON.parse(File.read(COVERAGE_PATH))
+      raw_coverage = parse_coverage(data)
+
+      git_mode = @args[:git]
+      git_changed_lines = git_mode ? load_git_changes(git_mode) : {}
+
+      if git_mode && git_changed_lines.empty?
+        puts "No changed files found for git mode: #{git_mode}"
+        return
+      end
+
+      filter_pattern = @args[:filter] ? Regexp.new(@args[:filter], Regexp::IGNORECASE) : nil
+      file_stats = []
+      total_lines = 0
+      covered_lines = 0
+
+      raw_coverage.each do |file_path, line_data|
+        next unless file_path.include?("/app/")
+
+        lines = extract_lines(line_data)
+        next if lines.nil?
+
+        short = file_path.sub(%r{.*/(?=app/)}, "")
+        next if filter_pattern && short !~ filter_pattern
+        next if git_mode && !git_changed_lines.key?(short)
+
+        stat = git_mode ? stat_for_changed(short, lines, git_changed_lines[short]) : stat_for_all(short, lines)
+        next if stat.nil?
+
+        total_lines   += stat[:total]
+        covered_lines += stat[:covered]
+        file_stats    << stat
+      end
+
+      if file_stats.empty?
+        puts "No matching files found."
+        return
+      end
+
+      overall = total_lines > 0 ? (covered_lines.to_f / total_lines * 100).round(2) : 0.0
+      header  = ["Coverage Report", filter_pattern && "[filter: #{@args[:filter]}]", git_mode && "[git: #{git_mode}]"].compact.join(" ")
+
+      puts "=" * 60
+      puts "  #{header}"
+      puts "  #{covered_lines}/#{total_lines} lines (#{overall}%)"
+      puts "=" * 60
+
+      sort_mode = (@args[:sort] || "worst").to_sym
+
+      file_stats.group_by { |f| f[:group] }.sort.each do |group_name, files|
+        g_total   = files.sum { |f| f[:total] }
+        g_covered = files.sum { |f| f[:covered] }
+        g_pct     = g_total > 0 ? (g_covered.to_f / g_total * 100).round(1) : 0.0
+
+        filtered = apply_sort(files, sort_mode)
+        next if filtered.empty?
+
+        label = git_mode ? "#{group_name} (changed lines)" : group_name
+        puts "\n--- #{label} (#{g_pct}% | #{g_covered}/#{g_total}) ---"
+        filtered.each do |f|
+          tag = f[:changed_only] ? " [changed]" : ""
+          puts "  #{f[:pct].to_s.rjust(5)}%  #{f[:path]}#{tag}  (#{f[:missed]} missed of #{f[:total]})"
+          next if f[:missed_lines].empty?
+          puts "         uncovered: #{format_line_ranges(f[:missed_lines])}"
+        end
+      end
+
+      puts
+    end
+
+    private
+
+    def parse_coverage(data)
+      if data["files"].is_a?(Array)
+        data["files"].each_with_object({}) { |f, h| h[f["filename"]] = f["coverage"] }
+      else
+        data["coverage"] || {}
+      end
+    end
+
+    def extract_lines(line_data)
+      case line_data
+      when Hash  then line_data["lines"]
+      when Array then line_data
+      end
+    end
+
+    def stat_for_changed(short, lines, changed_line_nums)
+      relevant = lines.each_with_index.select { |l, i| !l.nil? && changed_line_nums.include?(i + 1) }
+      cov      = relevant.count { |l, _| l > 0 }
+      miss     = relevant.count { |l, _| l == 0 }
+      return nil if (cov + miss) == 0
+      build_stat(short, cov, miss, relevant.select { |l, _| l == 0 }.map { |_, i| i + 1 }.sort, changed_only: true)
+    end
+
+    def stat_for_all(short, lines)
+      relevant   = lines.compact
+      cov        = relevant.count { |l| l > 0 }
+      miss       = relevant.count { |l| l == 0 }
+      miss_lines = lines.each_with_index.select { |l, _| l == 0 }.map { |_, i| i + 1 }.sort
+      return nil if (cov + miss) == 0
+      build_stat(short, cov, miss, miss_lines, changed_only: false)
+    end
+
+    def build_stat(short, cov, miss, miss_lines, changed_only:)
+      tot = cov + miss
+      {
+        path:         short,
+        pct:          (cov.to_f / tot * 100).round(1),
+        covered:      cov,
+        total:        tot,
+        missed:       miss,
+        missed_lines: miss_lines,
+        group:        detect_group(short),
+        changed_only: changed_only
+      }
+    end
+
+    def detect_group(short)
+      GROUPS.find { |prefix| short.start_with?(prefix) } || "app/other"
+    end
+
+    def apply_sort(files, mode)
+      case mode
+      when :uncovered then files.select { |f| f[:pct] == 0.0 }.sort_by { |f| -f[:total] }
+      when :partial   then files.select { |f| f[:pct] > 0 && f[:pct] < 100 }.sort_by { |f| f[:pct] }
+      when :full      then files.select { |f| f[:pct] == 100.0 }.sort_by { |f| -f[:total] }
+      else                 files.sort_by { |f| f[:pct] }
+      end
+    end
+
+    def format_line_ranges(line_nums)
+      return "" if line_nums.empty?
+      ranges, start = [], line_nums[0]
+      finish = start
+      line_nums[1..].each do |n|
+        n == finish + 1 ? (finish = n) : (ranges << range_str(start, finish); start = finish = n)
+      end
+      (ranges << range_str(start, finish)).join(", ")
+    end
+
+    def range_str(s, f) = s == f ? s.to_s : "#{s}-#{f}"
+
+    def load_git_changes(mode)
+      diff_output = case mode
+      when "staged"  then `git diff --cached --diff-filter=ACMR --unified=0 -- app/`
+      when "unstaged" then `git diff --diff-filter=ACMR --unified=0 -- app/`
+      when "head"
+        `git diff HEAD~1...HEAD --diff-filter=ACMR --unified=0 -- app/`
+      when "branch"
+        branch = `git rev-parse --abbrev-ref HEAD`.strip
+        base   = `git merge-base main #{branch} 2>/dev/null`.strip
+        base   = `git merge-base master #{branch} 2>/dev/null`.strip if base.empty?
+        base.empty? ? `git diff HEAD --diff-filter=ACMR --unified=0 -- app/` \
+                    : `git diff #{base}...HEAD --diff-filter=ACMR --unified=0 -- app/`
+      else
+        `git diff HEAD --diff-filter=ACMR --unified=0 -- app/`
+      end
+
+      result = {}
+      current_file = nil
+      diff_output.each_line do |line|
+        if line =~ %r{^\+\+\+ b/(app/.+)$}
+          current_file = $1.strip
+          result[current_file] ||= []
+        elsif line =~ /^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/
+          next unless current_file
+          start_line = $1.to_i
+          count      = [($2 || "1").to_i, 1].max
+          result[current_file].concat((start_line...(start_line + count)).to_a)
+        end
+      end
+      result
+    end
+  end
+end

data/lib/tasks/solid_loop_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :solid_loop do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,228 @@
+--- !ruby/object:Gem::Specification
+name: solid_loop
+version: !ruby/object:Gem::Version
+  version: 0.0.4
+platform: ruby
+authors:
+- Ruslan
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: event_stream_parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: Infrastructure layer for running autonomous AI agents as long-lived Rails
+  background processes (ActiveJob + PostgreSQL) using Middleware architecture and
+  MCP tools.
+email:
+- ru.ruslan@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/javascripts/solid_loop/chart.umd.min.js
+- app/assets/javascripts/solid_loop/chartjs-adapter-date-fns.bundle.min.js
+- app/assets/javascripts/solid_loop/chartkick.min.js
+- app/assets/stylesheets/solid_loop/application.css
+- app/controllers/solid_loop/application_controller.rb
+- app/controllers/solid_loop/dashboard_controller.rb
+- app/controllers/solid_loop/events_controller.rb
+- app/controllers/solid_loop/loops_controller.rb
+- app/controllers/solid_loop/mcp_inbound_sessions_controller.rb
+- app/controllers/solid_loop/mcp_sessions_controller.rb
+- app/controllers/solid_loop/mcp_tools_controller.rb
+- app/controllers/solid_loop/messages_controller.rb
+- app/controllers/solid_loop/tool_calls_controller.rb
+- app/helpers/solid_loop/application_helper.rb
+- app/jobs/solid_loop/application_job.rb
+- app/jobs/solid_loop/llm_completion_job.rb
+- app/jobs/solid_loop/observe_broadcast_job.rb
+- app/jobs/solid_loop/reaper_job.rb
+- app/jobs/solid_loop/tool_execution_job.rb
+- app/models/solid_loop/application_record.rb
+- app/models/solid_loop/base.rb
+- app/models/solid_loop/event.rb
+- app/models/solid_loop/loop.rb
+- app/models/solid_loop/mcp_inbound_session.rb
+- app/models/solid_loop/mcp_session.rb
+- app/models/solid_loop/mcp_tool.rb
+- app/models/solid_loop/message.rb
+- app/models/solid_loop/tool_call.rb
+- app/queries/solid_loop/admin/base_query.rb
+- app/queries/solid_loop/admin/events_query.rb
+- app/queries/solid_loop/admin/loops_query.rb
+- app/queries/solid_loop/admin/mcp_inbound_sessions_query.rb
+- app/queries/solid_loop/admin/mcp_sessions_query.rb
+- app/queries/solid_loop/admin/mcp_tools_query.rb
+- app/queries/solid_loop/admin/messages_query.rb
+- app/queries/solid_loop/admin/tool_calls_query.rb
+- app/services/solid_loop/adapters/native.rb
+- app/services/solid_loop/dialects/anthropic.rb
+- app/services/solid_loop/dialects/gemini.rb
+- app/services/solid_loop/dialects/open_ai.rb
+- app/services/solid_loop/dialects/reasoning_packer.rb
+- app/services/solid_loop/llm_usage_parser.rb
+- app/services/solid_loop/llm_usage_parser/anthropic.rb
+- app/services/solid_loop/llm_usage_parser/gemini.rb
+- app/services/solid_loop/llm_usage_parser/llama.rb
+- app/services/solid_loop/llm_usage_parser/openai.rb
+- app/services/solid_loop/mcp_session_initializer.rb
+- app/services/solid_loop/mcp_tool_execution_service.rb
+- app/services/solid_loop/middlewares/agent_initialization.rb
+- app/services/solid_loop/middlewares/error_handling.rb
+- app/services/solid_loop/middlewares/event_logging.rb
+- app/services/solid_loop/middlewares/message_building.rb
+- app/services/solid_loop/middlewares/network_calling.rb
+- app/services/solid_loop/middlewares/response_parsing.rb
+- app/services/solid_loop/middlewares/tool_call_xml_parser.rb
+- app/services/solid_loop/sse_stream_aggregator.rb
+- app/services/solid_loop/tool_failure_reconciler.rb
+- app/services/solid_loop/tool_middlewares/agent_initialization.rb
+- app/services/solid_loop/tool_middlewares/error_handling.rb
+- app/services/solid_loop/tool_middlewares/event_logging.rb
+- app/services/solid_loop/tool_middlewares/response_creation.rb
+- app/services/solid_loop/tool_middlewares/tool_execution.rb
+- app/views/layouts/solid_loop/admin.html.erb
+- app/views/layouts/solid_loop/application.html.erb
+- app/views/solid_loop/dashboard/index.html.erb
+- app/views/solid_loop/events/index.html.erb
+- app/views/solid_loop/events/show.html.erb
+- app/views/solid_loop/loops/index.html.erb
+- app/views/solid_loop/loops/show.html.erb
+- app/views/solid_loop/mcp_inbound_sessions/index.html.erb
+- app/views/solid_loop/mcp_inbound_sessions/show.html.erb
+- app/views/solid_loop/mcp_sessions/_tool_output.html.erb
+- app/views/solid_loop/mcp_sessions/index.html.erb
+- app/views/solid_loop/mcp_sessions/inspector.html.erb
+- app/views/solid_loop/mcp_sessions/show.html.erb
+- app/views/solid_loop/mcp_tools/index.html.erb
+- app/views/solid_loop/mcp_tools/show.html.erb
+- app/views/solid_loop/messages/_message.html.erb
+- app/views/solid_loop/messages/index.html.erb
+- app/views/solid_loop/messages/show.html.erb
+- app/views/solid_loop/shared/_pagination.html.erb
+- app/views/solid_loop/tool_calls/index.html.erb
+- app/views/solid_loop/tool_calls/show.html.erb
+- config/routes.rb
+- db/migrate/20260408000100_solid_loop_init.rb
+- db/migrate/20260709000100_solid_loop_create_mcp_inbound_sessions.rb
+- db/migrate/20260713000100_solid_loop_add_execution_guards.rb
+- db/migrate/20260714000100_solid_loop_add_message_steering.rb
+- db/migrate/20260714000200_solid_loop_add_message_conversation_order.rb
+- db/migrate/20260715000100_solid_loop_add_mcp_inbound_session_principal_key.rb
+- db/migrate/20260715000200_solid_loop_add_llm_lease.rb
+- db/migrate/20260715000300_solid_loop_add_tool_lease.rb
+- db/migrate/20260715000400_solid_loop_add_lease_running_check.rb
+- db/migrate/20260715000500_solid_loop_add_tool_lease_pair_check.rb
+- docs/contributing/coverage.md
+- docs/decisions/durable_attempt_lease.md
+- docs/decisions/mcp-only-tooling.md
+- docs/decisions/mcp-server.md
+- docs/decisions/reasoning_persistence.md
+- docs/decisions/ruby_llm_rejected.md
+- docs/guides/dialects.md
+- docs/guides/llm_middlewares.md
+- docs/guides/mcp_transports.md
+- docs/guides/tool_middlewares.md
+- lib/solid_loop.rb
+- lib/solid_loop/configuration.rb
+- lib/solid_loop/engine.rb
+- lib/solid_loop/lease_heartbeat.rb
+- lib/solid_loop/lease_renewer.rb
+- lib/solid_loop/llm_metrics.rb
+- lib/solid_loop/mcp.rb
+- lib/solid_loop/mcp/call_context.rb
+- lib/solid_loop/mcp/client_factory.rb
+- lib/solid_loop/mcp/http_transport.rb
+- lib/solid_loop/mcp/principal.rb
+- lib/solid_loop/mcp/result.rb
+- lib/solid_loop/mcp/server.rb
+- lib/solid_loop/mcp/stdio_transport.rb
+- lib/solid_loop/mcp/toolset.rb
+- lib/solid_loop/mcp/transport.rb
+- lib/solid_loop/mcp_client.rb
+- lib/solid_loop/pipeline.rb
+- lib/solid_loop/pipeline/builder.rb
+- lib/solid_loop/pipeline/context.rb
+- lib/solid_loop/pipeline/tool_context.rb
+- lib/solid_loop/reaper.rb
+- lib/solid_loop/version.rb
+- lib/tasks/coverage.rake
+- lib/tasks/solid_loop_tasks.rake
+homepage: https://github.com/ruslan/solid_loop
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/ruslan/solid_loop
+  changelog_uri: https://github.com/ruslan/solid_loop/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: ActiveJob-backed infrastructure for autonomous AI agents in Rails.
+test_files: []