mysql_genius-core 0.7.2 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 321f2469ac2b5213d704f7afd4ac6211a0a327d1c8d054c9fdb95843dd4b2bde
-  data.tar.gz: 62a5b202b55bf2ffa2c7d76b5c263c7685bd4d9de14f206903ae35604dd146ce
+  metadata.gz: 5075a444aed755238df78580fbd0e8ae79c2cb999ffc7504ff6af1ae8c08c8e7
+  data.tar.gz: 9edad6c0620a8c4434b716995ac7e0c2af52494c0f61912d45a1496468fa97e5
 SHA512:
-  metadata.gz: 5666c4264a19bfddb7052233e3d02c9499fdbf7ea6ffb3b0e4fa60c1bea117de03a3a349cf399b716cb947733050ac053a5cc52c287d2798b17ed7f6160c6306
-  data.tar.gz: c5f99646c2c9da80629824366b5ee1a0dcf7710cf84bf06f2cfe8e783d4f42b1a3fd0d4635a9ddc1fd7ff29ea5c7e4e77734bd4f995fef47ea0a32a6174e4504
+  metadata.gz: bd2263afa33f3b61b826d5667ba01d319f3cddd39c8b44dad0e24a50dd06ff23b69224322dc8b6762491f1f10fbe4f9e9ccf199fb9899586e99506b07e652fbe
+  data.tar.gz: 60f654e26bf1aef5fadfe996caa743911c7303d227e79c67ce6e4a5e6a3bfd4828afa6ccbc58be79b763f391a81f9e7d8e4ecaa273f220b1f0454da493750415

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # 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

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

@@ -62,7 +62,7 @@ module MysqlGenius
             response_format: { type: "json_object" },
             temperature: temperature,
           }
-          body[:max_tokens] = @config.max_tokens if @config.max_tokens
+          body[:max_tokens] = @config.max_tokens.to_i if @config.max_tokens
           body[:model] = @config.model if @config.model && !@config.model.empty?
           body
         end
@@ -73,7 +73,7 @@ module MysqlGenius
 
           body = {
             messages: user_messages,
-            max_tokens: @config.max_tokens || 4096,
+            max_tokens: (@config.max_tokens || 4096).to_i,
             temperature: temperature,
           }
           body[:system] = system_text unless system_text.empty?

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.2"
+    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

@@ -62,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/'
   };
 
@@ -301,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();
@@ -707,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);
     });
@@ -718,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';
@@ -748,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;
@@ -1033,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'));
@@ -1046,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() {
@@ -1387,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) {

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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mysql_genius-core
 version: !ruby/object:Gem::Version
-  version: 0.7.2
+  version: 0.8.0
 platform: ruby
 authors:
 - Antarr Byrd
@@ -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