mysql_genius-core 0.7.1 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dfc2a8ccac7f377e556a0c5f51b843e97b4882f20a49b24ba41b5ab9e4623268
-  data.tar.gz: 170b7fcfbdfab6e9aa20db0fef7dcbcf3d86018c8b41c35a0cbe927c3a8961c5
+  metadata.gz: 5075a444aed755238df78580fbd0e8ae79c2cb999ffc7504ff6af1ae8c08c8e7
+  data.tar.gz: 9edad6c0620a8c4434b716995ac7e0c2af52494c0f61912d45a1496468fa97e5
 SHA512:
-  metadata.gz: 4111e15ebb74f4139c854b7710f745509939228e5b8f55013fec9b69b0ed40249453686bee6c17254205c0fe907ed544104fdc049971a618d7376ff122019388
-  data.tar.gz: b2ddb49da235bfaac6ab6e75f9725d1f0162d6ded16ebf43dbd7e119d647c26cab3f12994213576636c5c8ee512722eb05ca3ee5ca9f229c594858b252051ff6
+  metadata.gz: bd2263afa33f3b61b826d5667ba01d319f3cddd39c8b44dad0e24a50dd06ff23b69224322dc8b6762491f1f10fbe4f9e9ccf199fb9899586e99506b07e652fbe
+  data.tar.gz: 60f654e26bf1aef5fadfe996caa743911c7303d227e79c67ce6e4a5e6a3bfd4828afa6ccbc58be79b763f391a81f9e7d8e4ecaa273f220b1f0454da493750415

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.8.0
+
+### Added
+- `MysqlGenius::Core::Ai::VariableReviewer` — reviews MySQL config variables against best practices
+- `MysqlGenius::Core::Ai::ConnectionAdvisor` — diagnoses connection pool health
+- `MysqlGenius::Core::Ai::WorkloadDigest` — executive summary of the query workload
+- `MysqlGenius::Core::Ai::InnodbInterpreter` — interprets `SHOW ENGINE INNODB STATUS` in plain English
+- `MysqlGenius::Core::Ai::IndexPlanner` — holistic index optimization plan across tables
+- `MysqlGenius::Core::Ai::PatternGrouper` — groups slow queries by shared root cause
+- AI buttons in shared dashboard templates: Server tab (Variable Review, Connection Advisor, InnoDB Health), Query Stats tab (Workload Digest, Pattern Grouper), Unused Indexes tab (Index Planner)
+
+## 0.7.2
+
+### Added
+- **Anthropic Messages API support** in `Core::Ai::Client` — detects `:x_api_key` auth style, sends `x-api-key` + `anthropic-version` headers, uses top-level `system` parameter and `content[0].text` response parsing.
+- **`max_tokens` field** on `Core::Ai::Config` (default 4096) — sent in both OpenAI and Anthropic request bodies.
+- **Copy response button** on all AI result sections in the shared dashboard template.
+- **Dark mode CSS classes** for AI result sections (`mg-ai-section`, `mg-ai-danger`, `mg-ai-warning`, `mg-ai-info`) replacing hardcoded inline styles.
+- **`capability?(:standalone_header)`** guard on the dashboard heading — hides it when the rendering adapter provides its own header.
+
 ## 0.7.1
 
 ### Fixed

data/lib/mysql_genius/core/ai/client.rb

@@ -27,12 +27,11 @@ module MysqlGenius
 
           raise NotConfigured, "AI is not configured" unless @config.enabled?
 
-          body = {
-            messages: messages,
-            response_format: { type: "json_object" },
-            temperature: temperature,
-          }
-          body[:model] = @config.model if @config.model && !@config.model.empty?
+          body = if anthropic?
+            build_anthropic_body(messages, temperature)
+          else
+            build_openai_body(messages, temperature)
+          end
 
           response = post_with_redirects(URI(@config.endpoint), body.to_json)
           parsed = JSON.parse(response.body)
@@ -41,7 +40,11 @@ module MysqlGenius
             raise ApiError, "AI API error: #{parsed["error"]["message"] || parsed["error"]}"
           end
 
-          content = parsed.dig("choices", 0, "message", "content")
+          content = if anthropic?
+            parsed.dig("content", 0, "text")
+          else
+            parsed.dig("choices", 0, "message", "content")
+          end
           raise ApiError, "No content in AI response" if content.nil?
 
           parse_json_content(content)
@@ -49,6 +52,35 @@ module MysqlGenius
 
         private
 
+        def anthropic?
+          @config.auth_style == :x_api_key
+        end
+
+        def build_openai_body(messages, temperature)
+          body = {
+            messages: messages,
+            response_format: { type: "json_object" },
+            temperature: temperature,
+          }
+          body[:max_tokens] = @config.max_tokens.to_i if @config.max_tokens
+          body[:model] = @config.model if @config.model && !@config.model.empty?
+          body
+        end
+
+        def build_anthropic_body(messages, temperature)
+          system_text = messages.select { |m| m[:role] == "system" }.map { |m| m[:content] }.join("\n\n")
+          user_messages = messages.reject { |m| m[:role] == "system" }
+
+          body = {
+            messages: user_messages,
+            max_tokens: (@config.max_tokens || 4096).to_i,
+            temperature: temperature,
+          }
+          body[:system] = system_text unless system_text.empty?
+          body[:model] = @config.model if @config.model && !@config.model.empty?
+          body
+        end
+
         def parse_json_content(content)
           JSON.parse(content)
         rescue JSON::ParserError
@@ -78,8 +110,12 @@ module MysqlGenius
 
           request = Net::HTTP::Post.new(uri)
           request["Content-Type"] = "application/json"
-          if @config.auth_style == :bearer
+          case @config.auth_style
+          when :bearer
             request["Authorization"] = "Bearer #{@config.api_key}"
+          when :x_api_key
+            request["x-api-key"] = @config.api_key
+            request["anthropic-version"] = "2023-06-01"
           else
             request["api-key"] = @config.api_key
           end

data/lib/mysql_genius/core/ai/config.rb

@@ -26,10 +26,11 @@ module MysqlGenius
         :auth_style,
         :system_context,
         :domain_context,
+        :max_tokens,
         keyword_init: true,
       ) do
         def initialize(**kwargs)
-          super(domain_context: "", **kwargs)
+          super(domain_context: "", max_tokens: 4096, **kwargs)
           freeze
         end
 

data/lib/mysql_genius/core/ai/connection_advisor.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module MysqlGenius
+  module Core
+    module Ai
+      # Diagnoses connection pool health by gathering connection-related
+      # metrics from SHOW GLOBAL STATUS and SHOW GLOBAL VARIABLES, then
+      # asking the LLM to distinguish between pool misconfiguration,
+      # connection leaks, missing pooling, and traffic saturation.
+      class ConnectionAdvisor
+        STATUS_KEYS = [
+          "Threads_connected",
+          "Threads_running",
+          "Max_used_connections",
+          "Aborted_connects",
+          "Aborted_clients",
+          "Connections",
+          "Threads_created",
+        ].freeze
+
+        VARIABLE_KEYS = [
+          "max_connections",
+          "wait_timeout",
+          "interactive_timeout",
+          "thread_cache_size",
+        ].freeze
+
+        def initialize(client, config, connection)
+          @client = client
+          @config = config
+          @connection = connection
+        end
+
+        def call
+          variables = fetch_variables
+          status = fetch_status
+
+          messages = [
+            { role: "system", content: system_prompt },
+            { role: "user",   content: user_prompt(variables, status) },
+          ]
+          @client.chat(messages: messages)
+        end
+
+        private
+
+        def fetch_variables
+          result = @connection.exec_query("SHOW GLOBAL VARIABLES")
+          result.rows
+            .select { |row| VARIABLE_KEYS.include?(row[0]) }
+            .map { |row| [row[0], row[1]] }
+        end
+
+        def fetch_status
+          result = @connection.exec_query("SHOW GLOBAL STATUS")
+          result.rows
+            .select { |row| STATUS_KEYS.include?(row[0]) }
+            .map { |row| [row[0], row[1]] }
+        end
+
+        def system_prompt
+          <<~PROMPT
+            You are a MySQL connection health advisor. Analyze the connection-related variables and status counters below, then diagnose the connection health and provide specific recommendations. Consider:
+            - Connection utilization: Max_used_connections vs max_connections (target: stay below 80%)
+            - Aborted connections: Aborted_connects indicates authentication failures or client errors; Aborted_clients indicates clients disconnecting without proper cleanup
+            - Thread cache efficiency: Threads_created vs Connections (high ratio means thread_cache_size is too small)
+            - Timeout configuration: wait_timeout and interactive_timeout impact how long idle connections persist
+            - Connection leak indicators: high Threads_connected with low Threads_running suggests idle connection accumulation
+            - Traffic saturation: high Threads_running relative to CPU cores suggests query contention
+
+            Distinguish between these root causes:
+            1. Pool misconfiguration (max_connections too low/high, bad timeout values)
+            2. Connection leaks (growing Threads_connected, high Aborted_clients)
+            3. Missing connection pooling (high Connections with short-lived threads)
+            4. Traffic saturation (high Threads_running, query contention)
+            #{@config.domain_context}
+            Respond with JSON: {"diagnosis": "markdown analysis distinguishing between pool misconfiguration, connection leaks, missing pooling, and traffic saturation, with specific variable recommendations and values"}
+          PROMPT
+        end
+
+        def user_prompt(variables, status)
+          lines = ["== Connection Variables =="]
+          variables.each { |name, value| lines << "#{name} = #{value}" }
+          lines << ""
+          lines << "== Connection Status Counters =="
+          status.each { |name, value| lines << "#{name} = #{value}" }
+          lines.join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/mysql_genius/core/ai/index_planner.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module MysqlGenius
+  module Core
+    module Ai
+      class IndexPlanner
+        def initialize(client, config, connection)
+          @client = client
+          @config = config
+          @connection = connection
+        end
+
+        def call(tables = nil)
+          target_tables = resolve_tables(tables)
+          return { "plan" => "No tables found to analyze." } if target_tables.empty?
+
+          unused = Analysis::UnusedIndexes.new(@connection).call
+          duplicates = Analysis::DuplicateIndexes.new(@connection, blocked_tables: []).call
+          schema = SchemaContextBuilder.new(@connection).call(target_tables, detail: :with_cardinality)
+
+          index_map = target_tables.to_h do |table|
+            [table, @connection.indexes_for(table).map do |idx|
+              "#{"UNIQUE " if idx.unique}INDEX #{idx.name} (#{idx.columns.join(", ")})"
+            end,]
+          end
+
+          messages = [
+            { role: "system", content: system_prompt },
+            { role: "user",   content: user_prompt(schema, unused, duplicates, index_map) },
+          ]
+          @client.chat(messages: messages)
+        end
+
+        private
+
+        def resolve_tables(tables)
+          list = Array(tables).reject { |t| t.to_s.empty? }
+          return list unless list.empty?
+
+          top_tables_by_size
+        end
+
+        def top_tables_by_size
+          db = @connection.current_database
+          result = @connection.exec_query(
+            "SELECT table_name FROM information_schema.tables " \
+              "WHERE table_schema = #{@connection.quote(db)} AND table_type = 'BASE TABLE' " \
+              "ORDER BY (data_length + index_length) DESC LIMIT 10",
+          )
+          result.rows.map(&:first)
+        rescue StandardError
+          @connection.tables.first(10)
+        end
+
+        def user_prompt(schema, unused, duplicates, index_map)
+          parts = ["Schema with cardinality:\n#{schema}"]
+
+          if unused.any?
+            unused_text = unused.map { |u| "#{u[:table]}.#{u[:index_name]} (reads=#{u[:reads]}, writes=#{u[:writes]})" }
+            parts << "Unused indexes (zero reads):\n#{unused_text.join("\n")}"
+          end
+
+          if duplicates.any?
+            dup_text = duplicates.map do |d|
+              "#{d[:table]}: #{d[:duplicate_index]} (#{d[:duplicate_columns].join(", ")}) covered by #{d[:covered_by_index]} (#{d[:covered_by_columns].join(", ")})"
+            end
+            parts << "Duplicate indexes:\n#{dup_text.join("\n")}"
+          end
+
+          index_summary = index_map.map { |table, idxs| "#{table}: #{idxs.any? ? idxs.join("; ") : "NONE"}" }
+          parts << "Current indexes per table:\n#{index_summary.join("\n")}"
+
+          parts.join("\n\n")
+        end
+
+        def system_prompt
+          <<~PROMPT
+            You are a MySQL index consolidation planner. Given schema information, unused indexes, duplicate indexes, and current index listings, produce a consolidated optimization plan. For each recommendation:
+            - DROP redundant or unused indexes (with exact ALTER TABLE ... DROP INDEX statements)
+            - MERGE overlapping indexes into composites where beneficial
+            - KEEP indexes that are actively used and well-structured
+            - ADD new composite indexes where query patterns suggest benefit
+            - Provide rationale for each change and estimated impact on read/write performance
+            #{@config.domain_context}
+            Respond with JSON: {"plan": "markdown with specific ALTER TABLE / DROP INDEX / CREATE INDEX statements, rationale for each change, and estimated impact"}
+          PROMPT
+        end
+      end
+    end
+  end
+end

data/lib/mysql_genius/core/ai/innodb_interpreter.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module MysqlGenius
+  module Core
+    module Ai
+      # Interprets SHOW ENGINE INNODB STATUS output in plain English.
+      # Combines the raw InnoDB status text with key metrics from
+      # ServerOverview to give the LLM full context for its analysis.
+      class InnodbInterpreter
+        MAX_STATUS_LENGTH = 4000
+
+        def initialize(client, config, connection)
+          @client = client
+          @config = config
+          @connection = connection
+        end
+
+        def call
+          status_text = fetch_innodb_status
+          metrics = fetch_innodb_metrics
+
+          messages = [
+            { role: "system", content: system_prompt },
+            { role: "user",   content: user_prompt(status_text, metrics) },
+          ]
+          @client.chat(messages: messages)
+        end
+
+        private
+
+        def fetch_innodb_status
+          result = @connection.exec_query("SHOW ENGINE INNODB STATUS")
+          text = result.rows.first&.dig(2).to_s
+          text.length > MAX_STATUS_LENGTH ? text[0, MAX_STATUS_LENGTH] : text
+        end
+
+        def fetch_innodb_metrics
+          overview = Analysis::ServerOverview.new(@connection).call
+          overview[:innodb]
+        end
+
+        def system_prompt
+          <<~PROMPT
+            You are a MySQL InnoDB internals expert. Analyze the SHOW ENGINE INNODB STATUS output and the supplementary metrics below. Provide a plain-English interpretation organized by these sections:
+            - **Deadlocks**: recent deadlock information, lock wait chains, affected transactions
+            - **Transaction History**: history list length, purge lag, long-running transactions
+            - **Buffer Pool**: hit rate, dirty page ratio, free pages, eviction pressure
+            - **I/O**: pending reads/writes, log sequence numbers, checkpoint age, log sizing adequacy
+            - **Semaphores**: mutex/rw-lock waits, spin rounds, OS waits indicating contention
+
+            For each section, explain what the numbers mean in practical terms and recommend specific actions if problems are detected.
+            #{@config.domain_context}
+            Respond with JSON: {"findings": "markdown analysis organized by: Deadlocks, Transaction History, Buffer Pool, I/O, Semaphores. Each section should include current state assessment, risk level, and actionable recommendations."}
+          PROMPT
+        end
+
+        def user_prompt(status_text, metrics)
+          lines = ["== SHOW ENGINE INNODB STATUS =="]
+          lines << status_text
+          lines << ""
+          lines << "== InnoDB Metrics Summary =="
+          lines << "Buffer Pool Size: #{metrics[:buffer_pool_mb]} MB"
+          lines << "Buffer Pool Hit Rate: #{metrics[:buffer_pool_hit_rate]}%"
+          lines << "Dirty Pages: #{metrics[:buffer_pool_pages_dirty]}"
+          lines << "Free Pages: #{metrics[:buffer_pool_pages_free]}"
+          lines << "Total Pages: #{metrics[:buffer_pool_pages_total]}"
+          lines << "Row Lock Waits: #{metrics[:row_lock_waits]}"
+          lines << "Row Lock Time (ms): #{metrics[:row_lock_time_ms]}"
+          lines.join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/mysql_genius/core/ai/pattern_grouper.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module MysqlGenius
+  module Core
+    module Ai
+      # Groups slow queries by shared root cause so a single fix can improve
+      # multiple queries at once. Pulls high-cost statements from
+      # performance_schema, extracts referenced tables, builds schema context,
+      # and asks the LLM to cluster queries by underlying issue.
+      #
+      # Construct with:
+      #   connection - a Core::Connection implementation
+      #   client     - a Core::Ai::Client
+      #   config     - the Core::Ai::Config
+      #
+      # Call:
+      #   .call() -> Hash with "groups" key containing markdown analysis
+      class PatternGrouper
+        QUERY_LIMIT = 30
+        ROWS_RATIO_THRESHOLD = 10
+        AVG_TIME_THRESHOLD = 50
+
+        def initialize(connection, client, config)
+          @connection = connection
+          @client = client
+          @config = config
+        end
+
+        def call
+          all_stats = Analysis::QueryStats.new(@connection).call(sort: "total_time", limit: QUERY_LIMIT)
+          high_cost = all_stats.select { |s| s[:rows_ratio] > ROWS_RATIO_THRESHOLD || s[:avg_time_ms] > AVG_TIME_THRESHOLD }
+          return { "groups" => "No high-cost queries found to analyze." } if high_cost.empty?
+
+          tables = extract_tables(high_cost)
+          schema = tables.any? ? SchemaContextBuilder.new(@connection).call(tables, detail: :basic) : ""
+
+          messages = [
+            { role: "system", content: system_prompt },
+            { role: "user",   content: user_prompt(high_cost, schema) },
+          ]
+
+          @client.chat(messages: messages)
+        end
+
+        private
+
+        def extract_tables(stats)
+          stats.flat_map { |s| SqlValidator.extract_table_references(s[:sql], @connection) }.uniq
+        end
+
+        def system_prompt
+          prompt = <<~PROMPT
+            You are a MySQL performance analyst specializing in root-cause analysis.
+          PROMPT
+
+          if @config.domain_context && !@config.domain_context.empty?
+            prompt += <<~PROMPT
+
+              Domain context:
+              #{@config.domain_context}
+            PROMPT
+          end
+
+          prompt += <<~PROMPT
+
+            Given a set of high-cost queries and the schema they reference, group them by shared root cause.
+            For each group provide:
+            1. The shared root cause (e.g., missing index, full table scan, implicit type conversion)
+            2. The affected queries (numbered)
+            3. A single fix that addresses all queries in the group (with exact SQL: CREATE INDEX, ALTER TABLE, etc.)
+            4. Estimated performance impact
+
+            Respond with JSON: {"groups": "markdown with each group showing: the shared root cause, affected queries (numbered), the single fix that addresses all of them (with exact SQL), and estimated impact"}
+          PROMPT
+
+          prompt
+        end
+
+        def user_prompt(stats, schema)
+          formatted = stats.map.with_index(1) do |s, i|
+            "#{i}. SQL: #{s[:sql]}\n   " \
+              "calls=#{s[:calls]}, avg_time_ms=#{s[:avg_time_ms]}, " \
+              "rows_ratio=#{s[:rows_ratio]}, rows_examined=#{s[:rows_examined]}, " \
+              "tmp_disk_tables=#{s[:tmp_disk_tables]}"
+          end.join("\n")
+
+          parts = ["High-cost queries (rows_ratio > #{ROWS_RATIO_THRESHOLD} OR avg_time_ms > #{AVG_TIME_THRESHOLD}):\n\n#{formatted}"]
+          parts << "Schema context:\n#{schema}" unless schema.empty?
+          parts.join("\n\n")
+        end
+      end
+    end
+  end
+end

data/lib/mysql_genius/core/ai/variable_reviewer.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module MysqlGenius
+  module Core
+    module Ai
+      # Reviews MySQL configuration variables against best practices for
+      # the observed workload. Gathers SHOW GLOBAL VARIABLES (filtered to
+      # ~20 performance-relevant keys) and SHOW GLOBAL STATUS, then asks
+      # the LLM to identify misconfigurations.
+      class VariableReviewer
+        RELEVANT_VARIABLES = [
+          "innodb_buffer_pool_size",
+          "innodb_log_file_size",
+          "innodb_flush_log_at_trx_commit",
+          "max_connections",
+          "query_cache_type",
+          "sort_buffer_size",
+          "join_buffer_size",
+          "tmp_table_size",
+          "max_heap_table_size",
+          "thread_cache_size",
+          "table_open_cache",
+          "innodb_file_per_table",
+          "innodb_flush_method",
+          "binlog_format",
+          "sync_binlog",
+          "innodb_io_capacity",
+          "innodb_read_io_threads",
+          "innodb_write_io_threads",
+          "long_query_time",
+          "slow_query_log",
+          "performance_schema",
+        ].freeze
+
+        RELEVANT_STATUS_KEYS = [
+          "Innodb_buffer_pool_reads",
+          "Innodb_buffer_pool_read_requests",
+          "Created_tmp_disk_tables",
+          "Created_tmp_tables",
+          "Sort_merge_passes",
+          "Threads_created",
+          "Threads_connected",
+          "Max_used_connections",
+          "Slow_queries",
+          "Questions",
+          "Uptime",
+        ].freeze
+
+        def initialize(client, config, connection)
+          @client = client
+          @config = config
+          @connection = connection
+        end
+
+        def call
+          variables = fetch_variables
+          status = fetch_status
+
+          messages = [
+            { role: "system", content: system_prompt },
+            { role: "user",   content: user_prompt(variables, status) },
+          ]
+          @client.chat(messages: messages)
+        end
+
+        private
+
+        def fetch_variables
+          result = @connection.exec_query("SHOW GLOBAL VARIABLES")
+          result.rows
+            .select { |row| RELEVANT_VARIABLES.include?(row[0]) }
+            .map { |row| [row[0], row[1]] }
+        end
+
+        def fetch_status
+          result = @connection.exec_query("SHOW GLOBAL STATUS")
+          result.rows
+            .select { |row| RELEVANT_STATUS_KEYS.include?(row[0]) }
+            .map { |row| [row[0], row[1]] }
+        end
+
+        def system_prompt
+          <<~PROMPT
+            You are a MySQL configuration reviewer. Analyze the server variables and status counters below, then identify misconfigurations and improvement opportunities. Consider:
+            - Buffer pool sizing relative to workload (hit rate from status counters)
+            - Temporary table spills to disk (tmp_table_size vs Created_tmp_disk_tables)
+            - Sort buffer and join buffer sizing
+            - Connection pool sizing (max_connections vs Max_used_connections)
+            - Thread cache effectiveness
+            - InnoDB flush and sync settings for durability vs performance trade-offs
+            - Slow query log configuration
+            - Binary log format suitability
+            #{@config.domain_context}
+            Respond with JSON: {"findings": "markdown-formatted analysis organized by severity (Critical, Warning, Suggestion). Include specific SET GLOBAL or my.cnf recommendations with before/after values."}
+          PROMPT
+        end
+
+        def user_prompt(variables, status)
+          lines = ["== Server Variables =="]
+          variables.each { |name, value| lines << "#{name} = #{value}" }
+          lines << ""
+          lines << "== Server Status Counters =="
+          status.each { |name, value| lines << "#{name} = #{value}" }
+          lines.join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/mysql_genius/core/ai/workload_digest.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module MysqlGenius
+  module Core
+    module Ai
+      # Produces a high-level executive summary of the query workload by
+      # pulling the top statements from performance_schema and asking the
+      # LLM to characterize read/write ratio, access patterns, waste
+      # concentration, and highest-leverage optimization opportunities.
+      #
+      # Construct with:
+      #   connection - a Core::Connection implementation
+      #   client     - a Core::Ai::Client
+      #   config     - the Core::Ai::Config
+      #
+      # Call:
+      #   .call() -> Hash with "digest" key containing markdown analysis
+      class WorkloadDigest
+        TOP_N = 30
+
+        def initialize(connection, client, config)
+          @connection = connection
+          @client = client
+          @config = config
+        end
+
+        def call
+          stats = Analysis::QueryStats.new(@connection).call(sort: "total_time", limit: TOP_N)
+          formatted = format_stats(stats)
+
+          messages = [
+            { role: "system", content: system_prompt },
+            { role: "user", content: user_prompt(formatted, stats.length) },
+          ]
+
+          @client.chat(messages: messages)
+        end
+
+        private
+
+        def system_prompt
+          prompt = <<~PROMPT
+            You are a MySQL performance analyst producing an executive workload digest.
+          PROMPT
+
+          if @config.domain_context && !@config.domain_context.empty?
+            prompt += <<~PROMPT
+
+              Domain context:
+              #{@config.domain_context}
+            PROMPT
+          end
+
+          prompt += <<~PROMPT
+
+            Analyze the provided query workload data and produce a concise executive summary covering:
+            1. Read vs write ratio and overall workload characterization
+            2. Access patterns (point lookups, range scans, full table scans, aggregations)
+            3. Waste concentration — which queries examine many rows but return few
+            4. Top 3 highest-leverage changes that would improve overall performance
+
+            Respond with JSON: {"digest": "markdown-formatted workload analysis"}
+          PROMPT
+
+          prompt
+        end
+
+        def user_prompt(formatted_stats, count)
+          <<~PROMPT
+            Top #{count} queries by total execution time:
+
+            #{formatted_stats}
+          PROMPT
+        end
+
+        def format_stats(stats)
+          stats.map.with_index(1) do |s, i|
+            "#{i}. SQL: #{s[:sql]}\n   " \
+              "calls=#{s[:calls]}, avg_time_ms=#{s[:avg_time_ms]}, " \
+              "rows_ratio=#{s[:rows_ratio]}, tmp_disk_tables=#{s[:tmp_disk_tables]}"
+          end.join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/mysql_genius/core/version.rb

@@ -2,6 +2,6 @@
 
 module MysqlGenius
   module Core
-    VERSION = "0.7.1"
+    VERSION = "0.8.0"
   end
 end

data/lib/mysql_genius/core/views/mysql_genius/queries/_shared_results.html.erb

@@ -26,13 +26,16 @@
 </div>
 
 <!-- Results Area -->
-<div id="query-results" class="mg-mt">
-  <div id="results-alert" class="mg-hidden"></div>
-  <div id="results-stats" class="mg-mb mg-hidden">
-    <span id="results-row-count" class="mg-badge mg-badge-info"></span>
-    <span id="results-time" class="mg-badge mg-badge-secondary"></span>
-    <span id="results-truncated" class="mg-badge mg-badge-warning mg-hidden">Results truncated</span>
+<div id="query-results" class="mg-mt mg-hidden">
+  <div style="display:flex;justify-content:space-between;align-items:center;">
+    <div id="results-stats" class="mg-mb mg-hidden">
+      <span id="results-row-count" class="mg-badge mg-badge-info"></span>
+      <span id="results-time" class="mg-badge mg-badge-secondary"></span>
+      <span id="results-truncated" class="mg-badge mg-badge-warning mg-hidden">Results truncated</span>
+    </div>
+    <button id="results-close" class="mg-btn mg-btn-outline-secondary mg-btn-sm" style="margin-bottom:12px;">&#10005; Dismiss</button>
   </div>
+  <div id="results-alert" class="mg-hidden"></div>
   <div id="results-table-wrapper" class="mg-table-wrap mg-hidden">
     <table class="mg-table">
       <thead id="results-thead"></thead>

data/lib/mysql_genius/core/views/mysql_genius/queries/_tab_query_stats.html.erb

@@ -2,6 +2,23 @@
 <div class="mg-tab-content" id="tab-qstats">
   <div class="mg-row" style="justify-content:space-between;align-items:center;margin-bottom:12px;">
     <div class="mg-text-muted">Top queries from <code>performance_schema.events_statements_summary_by_digest</code>. <span id="qstats-count" class="mg-badge mg-badge-secondary"></span></div>
+    <div style="display:flex;gap:4px;">
+      <% if @ai_enabled %>
+        <button id="qstats-workload-digest" class="mg-btn mg-btn-outline mg-btn-sm">&#9889; Workload Digest</button>
+        <button id="qstats-pattern-grouper" class="mg-btn mg-btn-outline mg-btn-sm">&#9889; Pattern Grouper</button>
+      <% end %>
+    </div>
+  </div>
+  <div id="qstats-ai-result" class="mg-mt mg-hidden" style="margin-bottom:12px;">
+    <div class="mg-card">
+      <div class="mg-card-header">
+        <span id="qstats-ai-title"><strong>&#9889; AI Analysis</strong></span>
+        <button id="qstats-ai-close" class="mg-btn mg-btn-outline-secondary mg-btn-sm">&#10005;</button>
+      </div>
+      <div class="mg-card-body">
+        <div id="qstats-ai-content" style="font-size:13px;"></div>
+      </div>
+    </div>
   </div>
   <div id="qstats-loading" class="mg-text-center mg-hidden"><span class="mg-spinner"></span> Loading...</div>
   <div id="qstats-error" class="mg-hidden"></div>

data/lib/mysql_genius/core/views/mysql_genius/queries/_tab_server.html.erb

@@ -1,10 +1,15 @@
 <!-- Server Tab -->
 <div class="mg-tab-content" id="tab-server">
-  <div class="mg-row" style="justify-content:flex-end;margin-bottom:12px;">
+  <div class="mg-row" style="justify-content:flex-end;margin-bottom:12px;flex-wrap:wrap;gap:4px;">
     <% if @ai_enabled && capability?(:slow_queries) %>
       <button id="server-root-cause" class="mg-btn mg-btn-primary mg-btn-sm">&#9889; Why is it slow?</button>
       <button id="server-anomaly" class="mg-btn mg-btn-outline mg-btn-sm">&#9889; Anomaly Detection</button>
     <% end %>
+    <% if @ai_enabled %>
+      <button id="server-variable-review" class="mg-btn mg-btn-outline mg-btn-sm">&#9889; Variable Review</button>
+      <button id="server-connection-advisor" class="mg-btn mg-btn-outline mg-btn-sm">&#9889; Connection Advisor</button>
+      <button id="server-innodb-health" class="mg-btn mg-btn-outline mg-btn-sm">&#9889; InnoDB Health</button>
+    <% end %>
     <button id="server-refresh" class="mg-btn mg-btn-outline-secondary mg-btn-sm">&#8635; Refresh</button>
   </div>
   <div id="server-loading" class="mg-text-center mg-hidden"><span class="mg-spinner"></span> Loading...</div>

data/lib/mysql_genius/core/views/mysql_genius/queries/_tab_unused_indexes.html.erb

@@ -2,7 +2,23 @@
 <div class="mg-tab-content" id="tab-unused">
   <div class="mg-row" style="justify-content:space-between;align-items:center;margin-bottom:12px;">
     <div class="mg-text-muted">Indexes with zero reads since last server restart, from <code>performance_schema</code>. <span id="unused-count" class="mg-badge mg-badge-secondary"></span></div>
-    <button id="unused-refresh" class="mg-btn mg-btn-outline-secondary mg-btn-sm">&#8635; Refresh</button>
+    <div style="display:flex;gap:4px;">
+      <% if @ai_enabled %>
+        <button id="unused-index-planner" class="mg-btn mg-btn-outline mg-btn-sm">&#9889; Index Planner</button>
+      <% end %>
+      <button id="unused-refresh" class="mg-btn mg-btn-outline-secondary mg-btn-sm">&#8635; Refresh</button>
+    </div>
+  </div>
+  <div id="unused-ai-result" class="mg-mt mg-hidden" style="margin-bottom:12px;">
+    <div class="mg-card">
+      <div class="mg-card-header">
+        <span id="unused-ai-title"><strong>&#9889; Index Planner</strong></span>
+        <button id="unused-ai-close" class="mg-btn mg-btn-outline-secondary mg-btn-sm">&#10005;</button>
+      </div>
+      <div class="mg-card-body">
+        <div id="unused-ai-content" style="font-size:13px;"></div>
+      </div>
+    </div>
   </div>
   <div id="unused-loading" class="mg-text-center mg-hidden"><span class="mg-spinner"></span> Scanning...</div>
   <div id="unused-error" class="mg-hidden"></div>

data/lib/mysql_genius/core/views/mysql_genius/queries/dashboard.html.erb

@@ -1,9 +1,11 @@
+<% if capability?(:standalone_header) %>
 <div style="display:flex;align-items:center;justify-content:space-between;">
   <h4>&#128024; MySQLGenius</h4>
   <button class="mg-theme-toggle" id="mg-theme-btn" title="Toggle dark/light theme" onclick="(function(){var d=document.documentElement,t=d.getAttribute('data-theme')==='dark'?'light':'dark';d.setAttribute('data-theme',t);localStorage.setItem('mg-theme',t);document.getElementById('mg-theme-btn').textContent=t==='dark'?'\u2600\uFE0F':'\uD83C\uDF19';})()">
     <script>document.write(document.documentElement.getAttribute('data-theme')==='dark'?'\u2600\uFE0F':'\uD83C\uDF19')</script>
   </button>
 </div>
+<% end %>
 
 <div class="mg-tabs">
   <button class="mg-tab active" data-tab="dashboard">Dashboard</button>
@@ -60,6 +62,12 @@
     anomaly_detection: '<%= path_for(:anomaly_detection) %>',
     root_cause: '<%= path_for(:root_cause) %>',
     migration_risk: '<%= path_for(:migration_risk) %>',
+    variable_review: '<%= path_for(:variable_review) %>',
+    connection_advisor: '<%= path_for(:connection_advisor) %>',
+    workload_digest: '<%= path_for(:workload_digest) %>',
+    innodb_health: '<%= path_for(:innodb_health) %>',
+    index_planner: '<%= path_for(:index_planner) %>',
+    pattern_grouper: '<%= path_for(:pattern_grouper) %>',
     query_detail: '/queries/'
   };
 
@@ -299,6 +307,13 @@
     btn.classList.add('active');
     el('tab-' + name).classList.add('active');
     history.replaceState(null, '', location.pathname + '#' + name);
+
+    // Hide query results and AI responses when leaving the explorer tab
+    if (name !== 'explorer') {
+      hide(el('query-results'));
+      hide(el('explain-results'));
+      hide(el('ai-query-result'));
+    }
     if (name === 'dashboard') loadDashboard();
     if (name === 'slow') loadSlowQueries();
     if (name === 'indexes') loadDuplicateIndexes();
@@ -705,6 +720,7 @@
     }, function(json) {
       var cls = (json && json.timeout) ? 'mg-alert-warning' : 'mg-alert-danger';
       el('results-alert').innerHTML = '<div class="mg-alert ' + cls + '">' + escHtml((json && json.error) || 'An unexpected error occurred.') + '</div>';
+      show(el('query-results'));
       show(el('results-alert'));
       setBtnLoading(['vb-run', 'sql-run'], false);
     });
@@ -716,9 +732,11 @@
     hide(el('results-truncated'));
     el('results-thead').innerHTML = '';
     el('results-tbody').innerHTML = '';
+    show(el('query-results'));
   }
 
   function renderResults(data) {
+    show(el('query-results'));
     if (data.row_count === 0) {
       show(el('results-empty')); show(el('results-stats'));
       el('results-row-count').textContent = '0 rows';
@@ -746,6 +764,7 @@
   el('vb-explain').addEventListener('click', function() { var sql = buildSql(); if (sql) runExplain(sql); });
   el('sql-explain').addEventListener('click', function() { var sql = el('sql-input').value.trim(); if (sql) runExplain(sql); });
   el('explain-close').addEventListener('click', function() { hide(el('explain-results')); });
+  el('results-close').addEventListener('click', function() { hide(el('query-results')); });
 
   function runExplain(sql, fromSlowQuery) {
     lastExplainSql = sql;
@@ -825,7 +844,7 @@
       });
 
       ajax('POST', ROUTES.optimize, data, function(resp) {
-        el('optimize-content').innerHTML = formatMarkdown(resp.suggestions || 'No suggestions available.');
+        el('optimize-content').innerHTML = formatMarkdown(resp.suggestions || 'No suggestions available.') + copyButton('optimize-content');
         show(el('optimize-results'));
         explainOptimize.disabled = false;
         explainOptimize.innerHTML = '&#9889; AI Optimization';
@@ -1031,7 +1050,9 @@
           '<td class="mg-num"><strong>' + formatMb(t.total_mb) + '</strong></td>' +
           '<td class="mg-num">' + fragText + '</td>' +
           '<td>' + updated + '</td>' +
-          '<td>' + sizeBar(pct, color) + '</td>' +
+          '<td>' + sizeBar(pct, color) +
+            (t.needs_optimize ? ' <button class="mg-btn mg-btn-outline mg-btn-sm mg-table-optimize" data-table="' + escHtml(t.table) + '" style="margin-left:4px;">&#9889; AI Optimize</button>' : '') +
+          '</td>' +
           '</tr>';
       }).join('');
       show(el('sizes-table-wrapper'));
@@ -1044,6 +1065,24 @@
 
   el('sizes-refresh').addEventListener('click', loadTableSizes);
 
+  // AI Optimize button on tables with fragmentation
+  document.addEventListener('click', function(e) {
+    var btn = e.target.closest('.mg-table-optimize');
+    if (!btn) return;
+    var table = btn.dataset.table;
+    btn.disabled = true;
+    btn.innerHTML = '<span class="mg-spinner"></span>';
+    aiCall(ROUTES.schema_review, { table: table }, function(data) {
+      showAiQueryResult('Optimization: ' + table, formatFindings(data.findings || data.raw || 'No suggestions.'));
+      btn.disabled = false;
+      btn.innerHTML = '&#9889; AI Optimize';
+    }, function(err) {
+      showAiQueryResult('Error', '<div class="mg-alert mg-alert-danger">' + escHtml(err) + '</div>');
+      btn.disabled = false;
+      btn.innerHTML = '&#9889; AI Optimize';
+    });
+  });
+
   // --- Query Stats ---
 
   function loadQueryStats() {
@@ -1230,9 +1269,25 @@
     });
   }
 
+  function copyButton(targetId) {
+    return '<div style="text-align:right;margin-top:8px;"><button class="mg-btn mg-btn-outline-secondary mg-btn-sm mg-copy-ai" data-target="' + targetId + '">Copy response</button></div>';
+  }
+
+  document.addEventListener('click', function(e) {
+    var btn = e.target.closest('.mg-copy-ai');
+    if (!btn) return;
+    var target = el(btn.dataset.target);
+    if (!target) return;
+    var text = target.innerText || target.textContent;
+    navigator.clipboard.writeText(text).then(function() {
+      btn.textContent = 'Copied!';
+      setTimeout(function() { btn.textContent = 'Copy response'; }, 2000);
+    });
+  });
+
   function showAiQueryResult(title, html) {
     el('ai-query-title').innerHTML = '<strong>&#9889; ' + escHtml(title) + '</strong>';
-    el('ai-query-content').innerHTML = html;
+    el('ai-query-content').innerHTML = html + copyButton('ai-query-content');
     show(el('ai-query-result'));
   }
 
@@ -1306,7 +1361,7 @@
       });
 
       aiCall(ROUTES.index_advisor, data, function(resp) {
-        el('optimize-content').innerHTML = formatMarkdown(resp.indexes || resp.raw || 'No suggestions.');
+        el('optimize-content').innerHTML = formatMarkdown(resp.indexes || resp.raw || 'No suggestions.') + copyButton('optimize-content');
         show(el('optimize-results'));
         indexAdvisor.disabled = false;
         indexAdvisor.innerHTML = '&#9889; Index Advisor';
@@ -1329,7 +1384,7 @@
       hide(el('server-ai-result'));
       aiCall(ROUTES.root_cause, {}, function(data) {
         el('server-ai-title').innerHTML = '<strong>&#9889; Root Cause Analysis</strong>';
-        el('server-ai-content').innerHTML = formatMarkdown(data.diagnosis || data.raw || 'No diagnosis.');
+        el('server-ai-content').innerHTML = formatMarkdown(data.diagnosis || data.raw || 'No diagnosis.') + copyButton('server-ai-content');
         show(el('server-ai-result'));
         rootCauseBtn.disabled = false;
         rootCauseBtn.innerHTML = '&#9889; Why is it slow?';
@@ -1354,7 +1409,7 @@
       hide(el('server-ai-result'));
       aiCall(ROUTES.anomaly_detection, {}, function(data) {
         el('server-ai-title').innerHTML = '<strong>&#9889; Query Health Report</strong>';
-        el('server-ai-content').innerHTML = formatMarkdown(data.report || data.raw || 'No anomalies detected.');
+        el('server-ai-content').innerHTML = formatMarkdown(data.report || data.raw || 'No anomalies detected.') + copyButton('server-ai-content');
         show(el('server-ai-result'));
         anomalyBtn.disabled = false;
         anomalyBtn.innerHTML = '&#9889; Anomaly Detection';
@@ -1369,6 +1424,148 @@
   }
   <% end %>
 
+  // Server: Variable Review
+  var varReviewBtn = el('server-variable-review');
+  if (varReviewBtn) {
+    varReviewBtn.addEventListener('click', function() {
+      varReviewBtn.disabled = true;
+      varReviewBtn.innerHTML = '<span class="mg-spinner"></span> Reviewing...';
+      hide(el('server-ai-result'));
+      aiCall(ROUTES.variable_review, {}, function(data) {
+        el('server-ai-title').innerHTML = '<strong>&#9889; Variable Configuration Review</strong>';
+        el('server-ai-content').innerHTML = formatMarkdown(data.findings || data.raw || 'No findings.') + copyButton('server-ai-content');
+        show(el('server-ai-result'));
+        varReviewBtn.disabled = false;
+        varReviewBtn.innerHTML = '&#9889; Variable Review';
+      }, function(err) {
+        el('server-ai-title').innerHTML = '<strong>&#9889; Error</strong>';
+        el('server-ai-content').innerHTML = '<div class="mg-alert mg-alert-danger">' + escHtml(err) + '</div>';
+        show(el('server-ai-result'));
+        varReviewBtn.disabled = false;
+        varReviewBtn.innerHTML = '&#9889; Variable Review';
+      });
+    });
+  }
+
+  // Server: Connection Advisor
+  var connAdvisorBtn = el('server-connection-advisor');
+  if (connAdvisorBtn) {
+    connAdvisorBtn.addEventListener('click', function() {
+      connAdvisorBtn.disabled = true;
+      connAdvisorBtn.innerHTML = '<span class="mg-spinner"></span> Diagnosing...';
+      hide(el('server-ai-result'));
+      aiCall(ROUTES.connection_advisor, {}, function(data) {
+        el('server-ai-title').innerHTML = '<strong>&#9889; Connection Pressure Diagnosis</strong>';
+        el('server-ai-content').innerHTML = formatMarkdown(data.diagnosis || data.raw || 'No diagnosis.') + copyButton('server-ai-content');
+        show(el('server-ai-result'));
+        connAdvisorBtn.disabled = false;
+        connAdvisorBtn.innerHTML = '&#9889; Connection Advisor';
+      }, function(err) {
+        el('server-ai-title').innerHTML = '<strong>&#9889; Error</strong>';
+        el('server-ai-content').innerHTML = '<div class="mg-alert mg-alert-danger">' + escHtml(err) + '</div>';
+        show(el('server-ai-result'));
+        connAdvisorBtn.disabled = false;
+        connAdvisorBtn.innerHTML = '&#9889; Connection Advisor';
+      });
+    });
+  }
+
+  // Server: InnoDB Health
+  var innodbHealthBtn = el('server-innodb-health');
+  if (innodbHealthBtn) {
+    innodbHealthBtn.addEventListener('click', function() {
+      innodbHealthBtn.disabled = true;
+      innodbHealthBtn.innerHTML = '<span class="mg-spinner"></span> Interpreting...';
+      hide(el('server-ai-result'));
+      aiCall(ROUTES.innodb_health, {}, function(data) {
+        el('server-ai-title').innerHTML = '<strong>&#9889; InnoDB Health Interpretation</strong>';
+        el('server-ai-content').innerHTML = formatMarkdown(data.findings || data.raw || 'No findings.') + copyButton('server-ai-content');
+        show(el('server-ai-result'));
+        innodbHealthBtn.disabled = false;
+        innodbHealthBtn.innerHTML = '&#9889; InnoDB Health';
+      }, function(err) {
+        el('server-ai-title').innerHTML = '<strong>&#9889; Error</strong>';
+        el('server-ai-content').innerHTML = '<div class="mg-alert mg-alert-danger">' + escHtml(err) + '</div>';
+        show(el('server-ai-result'));
+        innodbHealthBtn.disabled = false;
+        innodbHealthBtn.innerHTML = '&#9889; InnoDB Health';
+      });
+    });
+  }
+
+  // Query Stats: Workload Digest
+  var workloadBtn = el('qstats-workload-digest');
+  if (workloadBtn) {
+    workloadBtn.addEventListener('click', function() {
+      workloadBtn.disabled = true;
+      workloadBtn.innerHTML = '<span class="mg-spinner"></span> Analyzing...';
+      hide(el('qstats-ai-result'));
+      aiCall(ROUTES.workload_digest, {}, function(data) {
+        el('qstats-ai-title').innerHTML = '<strong>&#9889; Workload Digest</strong>';
+        el('qstats-ai-content').innerHTML = formatMarkdown(data.digest || data.raw || 'No digest available.') + copyButton('qstats-ai-content');
+        show(el('qstats-ai-result'));
+        workloadBtn.disabled = false;
+        workloadBtn.innerHTML = '&#9889; Workload Digest';
+      }, function(err) {
+        el('qstats-ai-title').innerHTML = '<strong>&#9889; Error</strong>';
+        el('qstats-ai-content').innerHTML = '<div class="mg-alert mg-alert-danger">' + escHtml(err) + '</div>';
+        show(el('qstats-ai-result'));
+        workloadBtn.disabled = false;
+        workloadBtn.innerHTML = '&#9889; Workload Digest';
+      });
+    });
+
+    el('qstats-ai-close').addEventListener('click', function() { hide(el('qstats-ai-result')); });
+  }
+
+  // Query Stats: Pattern Grouper
+  var patternBtn = el('qstats-pattern-grouper');
+  if (patternBtn) {
+    patternBtn.addEventListener('click', function() {
+      patternBtn.disabled = true;
+      patternBtn.innerHTML = '<span class="mg-spinner"></span> Grouping...';
+      hide(el('qstats-ai-result'));
+      aiCall(ROUTES.pattern_grouper, {}, function(data) {
+        el('qstats-ai-title').innerHTML = '<strong>&#9889; Slow Query Pattern Groups</strong>';
+        el('qstats-ai-content').innerHTML = formatMarkdown(data.groups || data.raw || 'No patterns found.') + copyButton('qstats-ai-content');
+        show(el('qstats-ai-result'));
+        patternBtn.disabled = false;
+        patternBtn.innerHTML = '&#9889; Pattern Grouper';
+      }, function(err) {
+        el('qstats-ai-title').innerHTML = '<strong>&#9889; Error</strong>';
+        el('qstats-ai-content').innerHTML = '<div class="mg-alert mg-alert-danger">' + escHtml(err) + '</div>';
+        show(el('qstats-ai-result'));
+        patternBtn.disabled = false;
+        patternBtn.innerHTML = '&#9889; Pattern Grouper';
+      });
+    });
+  }
+
+  // Unused Indexes: Index Planner
+  var indexPlannerBtn = el('unused-index-planner');
+  if (indexPlannerBtn) {
+    indexPlannerBtn.addEventListener('click', function() {
+      indexPlannerBtn.disabled = true;
+      indexPlannerBtn.innerHTML = '<span class="mg-spinner"></span> Planning...';
+      hide(el('unused-ai-result'));
+      aiCall(ROUTES.index_planner, {}, function(data) {
+        el('unused-ai-title').innerHTML = '<strong>&#9889; Index Consolidation Plan</strong>';
+        el('unused-ai-content').innerHTML = formatMarkdown(data.plan || data.raw || 'No plan generated.') + copyButton('unused-ai-content');
+        show(el('unused-ai-result'));
+        indexPlannerBtn.disabled = false;
+        indexPlannerBtn.innerHTML = '&#9889; Index Planner';
+      }, function(err) {
+        el('unused-ai-title').innerHTML = '<strong>&#9889; Error</strong>';
+        el('unused-ai-content').innerHTML = '<div class="mg-alert mg-alert-danger">' + escHtml(err) + '</div>';
+        show(el('unused-ai-result'));
+        indexPlannerBtn.disabled = false;
+        indexPlannerBtn.innerHTML = '&#9889; Index Planner';
+      });
+    });
+
+    el('unused-ai-close').addEventListener('click', function() { hide(el('unused-ai-result')); });
+  }
+
   // Schema Review
   var schemaBtn = el('schema-review-btn');
   if (schemaBtn) {
@@ -1378,7 +1575,7 @@
       hide(el('schema-result'));
       var table = el('schema-table').value;
       aiCall(ROUTES.schema_review, { table: table }, function(data) {
-        el('schema-result-content').innerHTML = formatFindings(data.findings || data.raw || '');
+        el('schema-result-content').innerHTML = formatFindings(data.findings || data.raw || '') + copyButton('schema-result-content');
         show(el('schema-result'));
         schemaBtn.disabled = false;
         schemaBtn.innerHTML = '&#9889; Analyze Schema';
@@ -1409,7 +1606,7 @@
         var level = (data.risk_level || '').toLowerCase();
         var badgeClass = level === 'critical' ? 'mg-badge-danger' : level === 'high' ? 'mg-badge-danger' : level === 'medium' ? 'mg-badge-warning' : 'mg-badge-info';
         el('migration-risk-badge').innerHTML = level ? '<span class="mg-badge ' + badgeClass + '" style="font-size:14px;padding:4px 12px;">Risk: ' + level.toUpperCase() + '</span>' : '';
-        el('migration-result-content').innerHTML = formatFindings(data.assessment || data.raw || '');
+        el('migration-result-content').innerHTML = formatFindings(data.assessment || data.raw || '') + copyButton('migration-result-content');
         show(el('migration-result'));
         migrationBtn.disabled = false;
         migrationBtn.innerHTML = '&#9889; Assess Risk';
@@ -1565,19 +1762,12 @@
 
     if (!sections.length) return formatMarkdown(text);
 
-    var badgeColors = { danger: '#dc3545', warning: '#ffc107', info: '#17a2b8' };
-    var bgColors = { danger: '#fff5f5', warning: '#fffbeb', info: '#f0f9ff' };
-    var borderColors = { danger: '#f5c6cb', warning: '#ffeeba', info: '#bee5eb' };
-
     return sections.map(function(sec) {
       var content = formatMarkdown(sec.lines.join('\n').trim());
       if (!content || content === '<br>') return '';
-      var badge = badgeColors[sec.severity] || badgeColors.info;
-      var bg = bgColors[sec.severity] || bgColors.info;
-      var border = borderColors[sec.severity] || borderColors.info;
-      return '<div class="mg-card mg-mb" style="border-left:4px solid ' + badge + ';background:' + bg + ';border-color:' + border + ';">' +
-        (sec.title ? '<div class="mg-card-header" style="background:transparent;border-bottom:1px solid ' + border + ';"><strong>' + escHtml(sec.title) + '</strong></div>' : '') +
-        '<div class="mg-card-body" style="font-size:13px;">' + content + '</div></div>';
+      return '<div class="mg-ai-section mg-ai-' + sec.severity + ' mg-mb">' +
+        (sec.title ? '<div class="mg-ai-section-header"><strong>' + escHtml(sec.title) + '</strong></div>' : '') +
+        '<div class="mg-ai-section-body">' + content + '</div></div>';
     }).filter(function(s) { return s; }).join('');
   }
 })();

data/lib/mysql_genius/core/views/mysql_genius/queries/query_detail.html.erb

@@ -411,13 +411,13 @@
   // --- Explain ---
 
   // performance_schema DIGEST_TEXT uses normalized spacing that isn't valid SQL:
-  //   "SELECT COUNT ( * ) FROM `riders`" → needs to become "SELECT COUNT(*) FROM `riders`"
-  //   "... IN ( ... )" → "... IN (...)"
+  //   "SELECT COUNT ( * ) FROM `riders`" -> needs to become "SELECT COUNT(*) FROM `riders`"
+  //   "... IN ( ... )" -> "... IN (...)"
   // Also replaces placeholder ? with 1 so EXPLAIN can parse it.
   function normalizeDigestSql(sql) {
     return sql
-      .replace(/\(\s+/g, '(')           // "( " → "("
-      .replace(/\s+\)/g, ')')           // " )" → ")"
+      .replace(/\(\s+/g, '(')           // "( " -> "("
+      .replace(/\s+\)/g, ')')           // " )" -> ")"
       .replace(/\s*,\s*/g, ', ')        // normalize comma spacing
       .replace(/\?/g, '1');             // replace ? placeholders with literal 1
   }

data/lib/mysql_genius/core.rb

@@ -41,6 +41,12 @@ require "mysql_genius/core/ai/schema_review"
 require "mysql_genius/core/ai/rewrite_query"
 require "mysql_genius/core/ai/index_advisor"
 require "mysql_genius/core/ai/migration_risk"
+require "mysql_genius/core/ai/variable_reviewer"
+require "mysql_genius/core/ai/connection_advisor"
+require "mysql_genius/core/ai/workload_digest"
+require "mysql_genius/core/ai/innodb_interpreter"
+require "mysql_genius/core/ai/index_planner"
+require "mysql_genius/core/ai/pattern_grouper"
 require "mysql_genius/core/analysis/table_sizes"
 require "mysql_genius/core/analysis/duplicate_indexes"
 require "mysql_genius/core/analysis/query_stats"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mysql_genius-core
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.8.0
 platform: ruby
 authors:
 - Antarr Byrd
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-12 00:00:00.000000000 Z
+date: 2026-04-13 00:00:00.000000000 Z
 dependencies: []
 description: Shared library used by the mysql_genius Rails engine and the mysql_genius-desktop
   standalone app. Contains the SQL validator, query runner, database analyses, and
@@ -24,14 +24,20 @@ files:
 - lib/mysql_genius/core.rb
 - lib/mysql_genius/core/ai/client.rb
 - lib/mysql_genius/core/ai/config.rb
+- lib/mysql_genius/core/ai/connection_advisor.rb
 - lib/mysql_genius/core/ai/describe_query.rb
 - lib/mysql_genius/core/ai/index_advisor.rb
+- lib/mysql_genius/core/ai/index_planner.rb
+- lib/mysql_genius/core/ai/innodb_interpreter.rb
 - lib/mysql_genius/core/ai/migration_risk.rb
 - lib/mysql_genius/core/ai/optimization.rb
+- lib/mysql_genius/core/ai/pattern_grouper.rb
 - lib/mysql_genius/core/ai/rewrite_query.rb
 - lib/mysql_genius/core/ai/schema_context_builder.rb
 - lib/mysql_genius/core/ai/schema_review.rb
 - lib/mysql_genius/core/ai/suggestion.rb
+- lib/mysql_genius/core/ai/variable_reviewer.rb
+- lib/mysql_genius/core/ai/workload_digest.rb
 - lib/mysql_genius/core/analysis/columns.rb
 - lib/mysql_genius/core/analysis/duplicate_indexes.rb
 - lib/mysql_genius/core/analysis/query_stats.rb