rails-profiler 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a0b42cc0bcdfe940609dbb07f9ee29a23cd00495c738711950749b22e58d664
-  data.tar.gz: b61678855bf48c082f4776773ce1754328c4e6b6d1672ea2542a836f79d9602a
+  metadata.gz: 6c1f16fad7d5792dda0491401519802bd402be3b6c952b898cc0930e675a0d49
+  data.tar.gz: 6ea6e3ca98b297f89b32da94a56cf73ff38788e8d31a9570dd58c072bfb58930
 SHA512:
-  metadata.gz: bde96bed30d2bc7fda19f62a10a2a1b9d55e1e73b83bc91ae0bba63ae7fb58a0d66ca692cb3db7ca66d17c29cfc69d190123095d6cc8f428e33e4d3030733b70
-  data.tar.gz: 310c1ddfc31ab16fddd783db87e24bbe10a5c48058f678215f389f66056ede8af928438f7a350fd4f9ab8828f49f6daf4cdffd4f41634c76b3f9d1f0a0840f0f
+  metadata.gz: 3e487bc2fc57bd9a1dee6eabdc45db629dd752e0df2ce95e74fc31701583ab5d8de72fa57b7b19dc81d6c412c6bec2b4a814768af84ab80da5af6c61b3fb063a
+  data.tar.gz: 0e3572af0b7f7bca2d1bc132da45173ad9dd2f29010d5685a987d247a89c114d5c76846781a5383aa7bee2fdef038059aa66ac8c9e8bf7ed1245c8a6eaf50354

data/app/assets/builds/profiler.css

@@ -867,6 +867,217 @@ tr:hover .btn-row-delete {
   line-height: 1.5;
 }
 
+.profiler-query-card--n1 {
+  border-left: 3px solid var(--profiler-warning);
+  background: var(--profiler-warning-bg);
+}
+
+.profiler-n1-group {
+  border: 1px solid var(--profiler-warning);
+  border-radius: var(--profiler-radius-md);
+  overflow: hidden;
+}
+.profiler-n1-group__header {
+  display: flex;
+  align-items: center;
+  gap: var(--profiler-space-3);
+  padding: var(--profiler-space-2) var(--profiler-space-3);
+  background: var(--profiler-warning-bg);
+  cursor: pointer;
+  user-select: none;
+}
+.profiler-n1-group__header:hover {
+  filter: brightness(0.97);
+}
+.profiler-n1-group__count {
+  font-size: var(--profiler-text-xs);
+  font-weight: 700;
+  font-family: var(--profiler-font-mono);
+  color: var(--profiler-warning);
+  white-space: nowrap;
+}
+.profiler-n1-group__pattern {
+  flex: 1;
+  font-size: var(--profiler-text-xs);
+  font-family: var(--profiler-font-mono);
+  color: var(--profiler-text);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.profiler-n1-group__toggle {
+  font-size: var(--profiler-text-xs);
+  color: var(--profiler-text-muted);
+  white-space: nowrap;
+}
+
+.profiler-n1-backtrace {
+  background: var(--profiler-bg-lighter);
+  border-top: 1px solid var(--profiler-border);
+  padding: var(--profiler-space-2) var(--profiler-space-3);
+}
+.profiler-n1-backtrace__frame {
+  font-size: var(--profiler-text-xs);
+  font-family: var(--profiler-font-mono);
+  color: var(--profiler-text-muted);
+  line-height: 1.8;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.profiler-alert-banner {
+  display: flex;
+  align-items: flex-start;
+  gap: var(--profiler-space-3);
+  padding: var(--profiler-space-3) var(--profiler-space-4);
+  border-radius: var(--profiler-radius-md);
+  border: 1px solid;
+  font-size: var(--profiler-text-sm);
+}
+.profiler-alert-banner--warning {
+  background: var(--profiler-warning-bg);
+  border-color: var(--profiler-warning);
+  color: var(--profiler-text);
+}
+.profiler-alert-banner--error {
+  background: var(--profiler-error-bg);
+  border-color: var(--profiler-error);
+}
+.profiler-alert-banner__icon {
+  flex-shrink: 0;
+  font-size: var(--profiler-text-base);
+}
+
+.profiler-badge {
+  display: inline-block;
+  padding: 1px 6px;
+  border-radius: var(--profiler-radius-sm);
+  font-size: var(--profiler-text-xs);
+  font-weight: 600;
+  font-family: var(--profiler-font-mono);
+  line-height: 1.6;
+}
+.profiler-badge--warning {
+  background: var(--profiler-warning-bg);
+  color: var(--profiler-warning);
+  border: 1px solid rgba(251, 146, 60, 0.3);
+}
+.profiler-badge--error {
+  background: var(--profiler-error-bg);
+  color: var(--profiler-error);
+}
+
+.profiler-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--profiler-space-1);
+  border: 1px solid var(--profiler-border);
+  border-radius: var(--profiler-radius-sm);
+  background: var(--profiler-bg-elevated);
+  color: var(--profiler-text-muted);
+  font-size: var(--profiler-text-sm);
+  font-family: var(--profiler-font-mono);
+  cursor: pointer;
+  transition: all var(--profiler-transition-base);
+}
+.profiler-btn:hover {
+  border-color: var(--profiler-accent);
+  color: var(--profiler-accent);
+}
+.profiler-btn--sm {
+  padding: 1px 8px;
+  font-size: var(--profiler-text-xs);
+}
+
+.profiler-modal__overlay {
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.6);
+  z-index: 9000;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: var(--profiler-space-4);
+}
+
+.profiler-modal {
+  background: var(--profiler-bg-elevated);
+  border: 1px solid var(--profiler-border);
+  border-radius: var(--profiler-radius-lg, var(--profiler-radius-md));
+  box-shadow: var(--profiler-shadow-lg, var(--profiler-shadow-sm));
+  width: 100%;
+  max-width: 760px;
+  max-height: 80vh;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+.profiler-modal__header {
+  display: flex;
+  align-items: center;
+  gap: var(--profiler-space-3);
+  padding: var(--profiler-space-3) var(--profiler-space-4);
+  border-bottom: 1px solid var(--profiler-border);
+  background: var(--profiler-bg-light);
+  flex-shrink: 0;
+}
+.profiler-modal__title {
+  font-weight: 600;
+  font-family: var(--profiler-font-mono);
+  font-size: var(--profiler-text-sm);
+  flex: 1;
+}
+.profiler-modal__close {
+  background: none;
+  border: none;
+  color: var(--profiler-text-muted);
+  font-size: var(--profiler-text-lg);
+  cursor: pointer;
+  padding: 0 var(--profiler-space-1);
+  line-height: 1;
+}
+.profiler-modal__close:hover {
+  color: var(--profiler-text);
+}
+.profiler-modal__body {
+  padding: var(--profiler-space-4);
+  overflow-y: auto;
+  flex: 1;
+}
+
+.profiler-explain-result {
+  font-family: var(--profiler-font-mono);
+  font-size: var(--profiler-text-xs);
+  color: var(--profiler-text);
+  white-space: pre-wrap;
+  word-break: break-all;
+  line-height: 1.6;
+  margin: 0;
+}
+
+.profiler-explain-node {
+  padding: var(--profiler-space-1) var(--profiler-space-2);
+  margin-bottom: 2px;
+  border-radius: var(--profiler-radius-sm);
+  font-family: var(--profiler-font-mono);
+  font-size: var(--profiler-text-xs);
+}
+.profiler-explain-node--expensive {
+  background: var(--profiler-error-bg);
+  border-left: 2px solid var(--profiler-error);
+}
+.profiler-explain-node__type {
+  font-weight: 600;
+  color: var(--profiler-accent);
+}
+.profiler-explain-node__stats {
+  display: flex;
+  gap: var(--profiler-space-3);
+  margin-top: 1px;
+  flex-wrap: wrap;
+}
+
 .profiler-dump-card {
   background: var(--profiler-bg-light);
   border: 1px solid var(--profiler-border);
@@ -1685,6 +1896,61 @@ a.profiler-toolbar-item.profiler-text--warning::after {
   cursor: pointer;
 }
 
+.profiler-preset-btn {
+  height: 28px;
+  padding: 0 10px;
+  background: transparent;
+  border: 1px solid var(--profiler-border);
+  border-radius: var(--profiler-radius-full);
+  color: var(--profiler-text-muted);
+  font-family: var(--profiler-font-sans);
+  font-size: var(--profiler-text-xs);
+  font-weight: 500;
+  cursor: pointer;
+  transition: all var(--profiler-transition-base);
+  white-space: nowrap;
+}
+.profiler-preset-btn:hover {
+  border-color: var(--profiler-accent);
+  color: var(--profiler-accent);
+  background: var(--profiler-accent-bg);
+}
+.profiler-preset-btn--active {
+  border-color: var(--profiler-accent);
+  background: var(--profiler-accent);
+  color: var(--profiler-text-on-accent, #fff);
+}
+.profiler-preset-btn--active:hover {
+  opacity: 0.85;
+  color: var(--profiler-text-on-accent, #fff);
+}
+
+.sortable {
+  cursor: pointer;
+  user-select: none;
+  white-space: nowrap;
+  transition: color var(--profiler-transition-base);
+}
+.sortable:hover {
+  color: var(--profiler-text) !important;
+}
+.sortable--active {
+  color: var(--profiler-text) !important;
+}
+
+.sort-icon {
+  font-size: 10px;
+  margin-left: 4px;
+  vertical-align: middle;
+}
+.sort-icon--idle {
+  opacity: 0.35;
+}
+.sort-icon--active {
+  color: var(--profiler-accent);
+  opacity: 1;
+}
+
 .profiler-timeline {
   margin: 24px 0;
   padding: 24px;
@@ -2110,6 +2376,33 @@ a.profiler-toolbar-item.profiler-text--warning::after {
   color: var(--profiler-text-subtle);
   font-family: var(--profiler-font-sans);
 }
+.profiler-flamegraph__search {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.profiler-flamegraph__search-input {
+  height: 28px;
+  padding: 0 8px;
+  background: var(--profiler-bg-lighter);
+  border: 1px solid var(--profiler-border);
+  border-radius: var(--profiler-radius-sm);
+  color: var(--profiler-text);
+  font-family: var(--profiler-font-mono);
+  font-size: var(--profiler-text-xs);
+  width: 200px;
+  transition: border-color var(--profiler-transition-base);
+}
+.profiler-flamegraph__search-input:focus {
+  outline: none;
+  border-color: var(--profiler-accent);
+}
+.profiler-flamegraph__match-count {
+  font-size: var(--profiler-text-xs);
+  font-family: var(--profiler-font-mono);
+  color: var(--profiler-text-muted);
+  white-space: nowrap;
+}
 .profiler-flamegraph__canvas-container {
   position: relative;
   border: 1px solid var(--profiler-border);

data/app/assets/builds/profiler.js

@@ -718,11 +718,26 @@
     if (!bytes) return "-";
     return (bytes / 1024 / 1024).toFixed(2) + " MB";
   }
+  var PRESETS = [
+    { key: "slow", label: "Slow" },
+    { key: "many_queries", label: "Many queries" },
+    { key: "errors", label: "Errors" },
+    { key: "has_exception", label: "Has exception" }
+  ];
   function ProfileList() {
+    const params = new URLSearchParams(window.location.search);
     const initialSection = () => {
-      const s3 = new URLSearchParams(window.location.search).get("section");
+      const s3 = params.get("section");
       return s3 === "http" || s3 === "jobs" || s3 === "outbound" ? s3 : "http";
     };
+    const initialSort = () => {
+      const col = params.get("sort");
+      const dir = params.get("dir");
+      return {
+        col: col === "duration" || col === "memory" || col === "status" || col === "queries" ? col : null,
+        dir: dir === "desc" ? "desc" : "asc"
+      };
+    };
     const [section, setSection] = d2(initialSection);
     const [profiles, setProfiles] = d2([]);
     const [jobs, setJobs] = d2([]);
@@ -740,6 +755,11 @@
     const [httpMethod, setHttpMethod] = d2("");
     const [httpStatus, setHttpStatus] = d2("");
     const [httpDuration, setHttpDuration] = d2("");
+    const [httpPreset, setHttpPreset] = d2(() => {
+      const p3 = params.get("preset");
+      return PRESETS.some((pr) => pr.key === p3) ? p3 : "";
+    });
+    const [httpSort, setHttpSort] = d2(initialSort);
     const [jobSearch, setJobSearch] = d2("");
     const [jobStatus, setJobStatus] = d2("");
     const [jobDuration, setJobDuration] = d2("");
@@ -759,6 +779,30 @@
       if (section === "jobs") loadJobs();
       if (section === "outbound") loadOutbound();
     }, []);
+    y2(() => {
+      const url = new URL(window.location.href);
+      if (httpSort.col) {
+        url.searchParams.set("sort", httpSort.col);
+        url.searchParams.set("dir", httpSort.dir);
+      } else {
+        url.searchParams.delete("sort");
+        url.searchParams.delete("dir");
+      }
+      if (httpPreset) {
+        url.searchParams.set("preset", httpPreset);
+      } else {
+        url.searchParams.delete("preset");
+      }
+      history.replaceState(null, "", url.toString());
+    }, [httpSort, httpPreset]);
+    const toggleHttpSort = (col) => {
+      setHttpSort(
+        (prev) => prev.col === col ? { col, dir: prev.dir === "asc" ? "desc" : "asc" } : { col, dir: "asc" }
+      );
+    };
+    const togglePreset = (key) => {
+      setHttpPreset((prev) => prev === key ? "" : key);
+    };
     const loadJobs = () => {
       if (jobsLoaded) return;
       setLoadingJobs(true);
@@ -796,6 +840,8 @@
       setHttpMethod("");
       setHttpStatus("");
       setHttpDuration("");
+      setHttpPreset("");
+      setHttpSort({ col: null, dir: "asc" });
       setJobSearch("");
       setJobStatus("");
       setJobDuration("");
@@ -870,8 +916,36 @@
       if (httpDuration) {
         if (httpDuration === "lt100" ? p3.duration >= 100 : p3.duration < parseInt(httpDuration)) return false;
       }
+      if (httpPreset === "slow" && p3.duration < 500) return false;
+      if (httpPreset === "many_queries" && (p3.collectors_data?.database?.total_queries ?? 0) <= 20) return false;
+      if (httpPreset === "errors" && p3.status < 500) return false;
+      if (httpPreset === "has_exception" && !p3.collectors_data?.exception) return false;
       return true;
     });
+    const sortedProfiles = httpSort.col ? [...filteredProfiles].sort((a3, b) => {
+      let av, bv;
+      switch (httpSort.col) {
+        case "duration":
+          av = a3.duration;
+          bv = b.duration;
+          break;
+        case "memory":
+          av = a3.memory ?? 0;
+          bv = b.memory ?? 0;
+          break;
+        case "status":
+          av = a3.status;
+          bv = b.status;
+          break;
+        case "queries":
+          av = a3.collectors_data?.database?.total_queries ?? 0;
+          bv = b.collectors_data?.database?.total_queries ?? 0;
+          break;
+        default:
+          return 0;
+      }
+      return httpSort.dir === "asc" ? av - bv : bv - av;
+    }) : filteredProfiles;
     const filteredJobs = jobs.filter((p3) => {
       if (jobSearch && !p3.path.toLowerCase().includes(jobSearch.toLowerCase())) return false;
       if (jobStatus === "failed" && p3.status !== 500) return false;
@@ -894,9 +968,13 @@
       }
       return true;
     });
-    const httpFiltersActive = !!(httpSearch || httpMethod || httpStatus || httpDuration);
+    const httpFiltersActive = !!(httpSearch || httpMethod || httpStatus || httpDuration || httpPreset);
     const jobFiltersActive = !!(jobSearch || jobStatus || jobDuration);
     const outboundFiltersActive = !!(outboundSearch || outboundMethod || outboundStatus);
+    const sortIcon = (col) => {
+      if (httpSort.col !== col) return /* @__PURE__ */ u3("span", { class: "sort-icon sort-icon--idle", children: "\u21C5" });
+      return /* @__PURE__ */ u3("span", { class: "sort-icon sort-icon--active", children: httpSort.dir === "asc" ? "\u25B2" : "\u25BC" });
+    };
     return /* @__PURE__ */ u3("div", { class: "container", children: [
       /* @__PURE__ */ u3("div", { class: "header", children: [
         /* @__PURE__ */ u3("h1", { children: [
@@ -925,6 +1003,15 @@
             /* @__PURE__ */ u3("div", { class: "profiler-empty__title", children: "No profiles found" }),
             /* @__PURE__ */ u3("p", { class: "profiler-empty__description", children: "Make some requests to your application to see profiling data" })
           ] }) : /* @__PURE__ */ u3(k, { children: [
+            /* @__PURE__ */ u3("div", { class: "profiler-action-bar profiler-mb-2", children: /* @__PURE__ */ u3("div", { class: "profiler-filter-group", children: PRESETS.map((preset) => /* @__PURE__ */ u3(
+              "button",
+              {
+                class: `profiler-preset-btn${httpPreset === preset.key ? " profiler-preset-btn--active" : ""}`,
+                onClick: () => togglePreset(preset.key),
+                children: preset.label
+              },
+              preset.key
+            )) }) }),
             /* @__PURE__ */ u3("div", { class: "profiler-action-bar profiler-mb-3", children: [
               /* @__PURE__ */ u3("div", { class: "profiler-filter-group", children: [
                 /* @__PURE__ */ u3(
@@ -974,13 +1061,26 @@
                 /* @__PURE__ */ u3("th", { children: "Time" }),
                 /* @__PURE__ */ u3("th", { children: "Method" }),
                 /* @__PURE__ */ u3("th", { children: "Path" }),
-                /* @__PURE__ */ u3("th", { children: "Duration" }),
-                /* @__PURE__ */ u3("th", { children: "Memory" }),
-                /* @__PURE__ */ u3("th", { children: "Status" }),
+                /* @__PURE__ */ u3("th", { class: `sortable${httpSort.col === "duration" ? " sortable--active" : ""}`, onClick: () => toggleHttpSort("duration"), children: [
+                  "Duration ",
+                  sortIcon("duration")
+                ] }),
+                /* @__PURE__ */ u3("th", { class: `sortable${httpSort.col === "queries" ? " sortable--active" : ""}`, onClick: () => toggleHttpSort("queries"), children: [
+                  "Queries ",
+                  sortIcon("queries")
+                ] }),
+                /* @__PURE__ */ u3("th", { class: `sortable${httpSort.col === "memory" ? " sortable--active" : ""}`, onClick: () => toggleHttpSort("memory"), children: [
+                  "Memory ",
+                  sortIcon("memory")
+                ] }),
+                /* @__PURE__ */ u3("th", { class: `sortable${httpSort.col === "status" ? " sortable--active" : ""}`, onClick: () => toggleHttpSort("status"), children: [
+                  "Status ",
+                  sortIcon("status")
+                ] }),
                 /* @__PURE__ */ u3("th", { children: "Token" }),
                 /* @__PURE__ */ u3("th", {})
               ] }) }),
-              /* @__PURE__ */ u3("tbody", { children: filteredProfiles.map((p3) => /* @__PURE__ */ u3("tr", { children: [
+              /* @__PURE__ */ u3("tbody", { children: sortedProfiles.map((p3) => /* @__PURE__ */ u3("tr", { children: [
                 /* @__PURE__ */ u3("td", { children: formatTime(p3.started_at) }),
                 /* @__PURE__ */ u3("td", { children: /* @__PURE__ */ u3("span", { class: methodClass(p3.method), children: p3.method }) }),
                 /* @__PURE__ */ u3("td", { children: /* @__PURE__ */ u3("a", { href: `${BASE}/profiles/${p3.token}`, children: p3.path }) }),
@@ -988,6 +1088,7 @@
                   p3.duration.toFixed(2),
                   " ms"
                 ] }) }),
+                /* @__PURE__ */ u3("td", { children: p3.collectors_data?.database?.total_queries ?? "\u2014" }),
                 /* @__PURE__ */ u3("td", { children: formatMemory(p3.memory) }),
                 /* @__PURE__ */ u3("td", { children: /* @__PURE__ */ u3("span", { class: statusClass(p3.status), children: p3.status }) }),
                 /* @__PURE__ */ u3("td", { class: "profiler-text--xs profiler-text--mono profiler-text--muted", children: /* @__PURE__ */ u3("button", { class: "token-copy", onClick: () => copyToken(p3.token), title: "Copy full token", children: copiedToken === p3.token ? "\u2713" : p3.token.substring(0, 8) + "\u2026" }) }),
@@ -1263,10 +1364,154 @@
   }
 
   // app/assets/typescript/profiler/components/dashboard/tabs/DatabaseTab.tsx
-  function DatabaseTab({ dbData }) {
+  function normalizeSql(sql) {
+    return sql.replace(/\$\d+/g, "?").replace(/\b\d+\b/g, "?").replace(/'[^']*'/g, "?").replace(/"[^"]*"/g, "?").trim();
+  }
+  function computeN1Groups(queries) {
+    const groups = /* @__PURE__ */ new Map();
+    queries.forEach((query, index) => {
+      if (query.cached || query.transaction) return;
+      const pattern = normalizeSql(query.sql);
+      if (!groups.has(pattern)) {
+        groups.set(pattern, { indices: [], backtrace: query.backtrace ?? [] });
+      }
+      groups.get(pattern).indices.push(index);
+    });
+    const result = [];
+    groups.forEach(({ indices, backtrace }, pattern) => {
+      if (indices.length >= 3) {
+        result.push({ pattern, indices, backtrace });
+      }
+    });
+    return result.sort((a3, b) => b.indices.length - a3.indices.length);
+  }
+  function renderPlanNode(node, depth = 0) {
+    const type = node["Node Type"] ?? "";
+    const actualRows = node["Actual Rows"] ?? 0;
+    const planRows = node["Plan Rows"] ?? 1;
+    const isExpensive = type.includes("Seq Scan") || type.includes("Hash Join") || type.includes("Nested Loop") || type.includes("Filter") || actualRows > 0 && planRows > 0 && actualRows > planRows * 10;
+    const children = node["Plans"] ?? [];
+    return /* @__PURE__ */ u3("div", { class: `profiler-explain-node${isExpensive ? " profiler-explain-node--expensive" : ""}`, style: `margin-left:${depth * 14}px`, children: [
+      /* @__PURE__ */ u3("span", { class: "profiler-explain-node__type", children: type }),
+      node["Relation Name"] && /* @__PURE__ */ u3("span", { class: "profiler-text--muted", children: [
+        " on ",
+        node["Relation Name"]
+      ] }),
+      node["Index Name"] && /* @__PURE__ */ u3("span", { class: "profiler-text--muted", children: [
+        " using ",
+        node["Index Name"]
+      ] }),
+      /* @__PURE__ */ u3("div", { class: "profiler-explain-node__stats profiler-text--xs profiler-text--muted", children: [
+        node["Actual Total Time"] != null && /* @__PURE__ */ u3("span", { children: [
+          "time: ",
+          node["Actual Total Time"].toFixed(3),
+          "ms"
+        ] }),
+        node["Actual Rows"] != null && /* @__PURE__ */ u3("span", { children: [
+          "rows: ",
+          actualRows,
+          " (est: ",
+          planRows,
+          ")"
+        ] }),
+        node["Total Cost"] != null && /* @__PURE__ */ u3("span", { children: [
+          "cost: ",
+          node["Total Cost"].toFixed(2)
+        ] }),
+        node["Filter"] && /* @__PURE__ */ u3("span", { class: "profiler-text--warning", children: [
+          "filter: ",
+          node["Filter"]
+        ] })
+      ] }),
+      children.map((child, i3) => renderPlanNode(child, depth + 1))
+    ] });
+  }
+  function ExplainModal({ state, onClose }) {
+    if (!state.open) return null;
+    const renderResult = () => {
+      if (state.loading) return /* @__PURE__ */ u3("div", { class: "profiler-text--muted", children: "Running EXPLAIN ANALYZE\u2026" });
+      if (state.error) return /* @__PURE__ */ u3("div", { class: "profiler-text--error", children: state.error });
+      if (!state.result) return null;
+      if (state.format === "json") {
+        try {
+          const parsed = typeof state.result === "string" ? JSON.parse(state.result) : state.result;
+          const plans = Array.isArray(parsed) ? parsed : [parsed];
+          return /* @__PURE__ */ u3("div", { class: "profiler-explain-result", children: plans.map((entry, i3) => /* @__PURE__ */ u3("div", { children: [
+            renderPlanNode(entry["Plan"] ?? entry),
+            entry["Planning Time"] != null && /* @__PURE__ */ u3("div", { class: "profiler-text--xs profiler-text--muted profiler-mt-2", children: [
+              "Planning: ",
+              entry["Planning Time"].toFixed(3),
+              "ms",
+              entry["Execution Time"] != null && /* @__PURE__ */ u3(k, { children: [
+                " \xB7 Execution: ",
+                entry["Execution Time"].toFixed(3),
+                "ms"
+              ] })
+            ] })
+          ] }, i3)) });
+        } catch {
+          return /* @__PURE__ */ u3("pre", { class: "profiler-explain-result", children: String(state.result) });
+        }
+      }
+      return /* @__PURE__ */ u3("pre", { class: "profiler-explain-result", children: String(state.result) });
+    };
+    return /* @__PURE__ */ u3("div", { class: "profiler-modal__overlay", onClick: onClose, children: /* @__PURE__ */ u3("div", { class: "profiler-modal", onClick: (e3) => e3.stopPropagation(), children: [
+      /* @__PURE__ */ u3("div", { class: "profiler-modal__header", children: [
+        /* @__PURE__ */ u3("span", { class: "profiler-modal__title", children: "EXPLAIN ANALYZE" }),
+        /* @__PURE__ */ u3("span", { class: "profiler-text--xs profiler-text--muted", children: state.adapter }),
+        /* @__PURE__ */ u3("button", { class: "profiler-modal__close", onClick: onClose, children: "\xD7" })
+      ] }),
+      /* @__PURE__ */ u3("div", { class: "profiler-modal__body", children: renderResult() })
+    ] }) });
+  }
+  function DatabaseTab({ dbData, token }) {
+    const [openBacktraces, setOpenBacktraces] = d2(/* @__PURE__ */ new Set());
+    const [explainState, setExplainState] = d2({
+      open: false,
+      loading: false,
+      result: null,
+      format: "text",
+      adapter: "",
+      error: null
+    });
     if (!dbData?.queries) {
       return /* @__PURE__ */ u3("div", { class: "profiler-empty", children: /* @__PURE__ */ u3("p", { class: "profiler-empty__description", children: "No database queries recorded" }) });
     }
+    const n1Groups = computeN1Groups(dbData.queries);
+    const n1IndexSet = new Set(n1Groups.flatMap((g2) => g2.indices));
+    const toggleBacktrace = (pattern) => {
+      setOpenBacktraces((prev) => {
+        const next = new Set(prev);
+        next.has(pattern) ? next.delete(pattern) : next.add(pattern);
+        return next;
+      });
+    };
+    const runExplain = async (queryIndex) => {
+      setExplainState({ open: true, loading: true, result: null, format: "text", adapter: "", error: null });
+      try {
+        const res = await fetch("/_profiler/api/explain", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ token, query_index: queryIndex })
+        });
+        if (!res.ok) {
+          const body = await res.json().catch(() => ({}));
+          setExplainState((s3) => ({ ...s3, loading: false, error: body.error ?? `HTTP ${res.status}` }));
+          return;
+        }
+        const data = await res.json();
+        setExplainState((s3) => ({
+          ...s3,
+          loading: false,
+          result: data.result,
+          format: data.format ?? "text",
+          adapter: data.adapter ?? ""
+        }));
+      } catch (err) {
+        setExplainState((s3) => ({ ...s3, loading: false, error: err.message ?? "Request failed" }));
+      }
+    };
+    const closeExplain = () => setExplainState((s3) => ({ ...s3, open: false }));
     return /* @__PURE__ */ u3(k, { children: [
       /* @__PURE__ */ u3("h2", { class: "profiler-section__header", children: [
         "Database Queries (",
@@ -1290,19 +1535,60 @@
           /* @__PURE__ */ u3("strong", { children: dbData.cached_queries })
         ] })
       ] }),
-      dbData.queries.map((query, index) => /* @__PURE__ */ u3("div", { class: `profiler-query-card${query.slow ? " profiler-query-card--slow" : ""}`, children: [
+      n1Groups.length > 0 && /* @__PURE__ */ u3("div", { class: "profiler-alert-banner profiler-alert-banner--warning profiler-mb-4", children: [
+        /* @__PURE__ */ u3("span", { class: "profiler-alert-banner__icon", children: "\u26A0\uFE0F" }),
+        /* @__PURE__ */ u3("div", { children: [
+          /* @__PURE__ */ u3("strong", { children: "Potential N+1 detected" }),
+          " \u2014 ",
+          n1Groups.length,
+          " pattern",
+          n1Groups.length > 1 ? "s" : "",
+          " repeated ",
+          n1Groups.reduce((sum, g2) => sum + g2.indices.length, 0),
+          " times total",
+          /* @__PURE__ */ u3("div", { class: "profiler-text--xs profiler-text--muted profiler-mt-1", children: "Queries causing N+1 are highlighted below. Expand each group to see the call stack." })
+        ] })
+      ] }),
+      n1Groups.map((group) => /* @__PURE__ */ u3("div", { class: "profiler-n1-group profiler-mb-4", children: [
+        /* @__PURE__ */ u3("div", { class: "profiler-n1-group__header", onClick: () => toggleBacktrace(group.pattern), children: [
+          /* @__PURE__ */ u3("span", { class: "profiler-n1-group__count", children: [
+            "N+1 \xB7 ",
+            group.indices.length,
+            "\xD7"
+          ] }),
+          /* @__PURE__ */ u3("code", { class: "profiler-n1-group__pattern", children: group.pattern }),
+          /* @__PURE__ */ u3("span", { class: "profiler-n1-group__toggle", children: [
+            openBacktraces.has(group.pattern) ? "\u25B2" : "\u25BC",
+            " backtrace"
+          ] })
+        ] }),
+        openBacktraces.has(group.pattern) && group.backtrace.length > 0 && /* @__PURE__ */ u3("div", { class: "profiler-n1-backtrace", children: group.backtrace.map((frame, i3) => /* @__PURE__ */ u3("div", { class: "profiler-n1-backtrace__frame", children: frame }, i3)) })
+      ] }, group.pattern)),
+      dbData.queries.map((query, index) => /* @__PURE__ */ u3("div", { class: [
+        "profiler-query-card",
+        query.slow ? "profiler-query-card--slow" : "",
+        n1IndexSet.has(index) ? "profiler-query-card--n1" : ""
+      ].filter(Boolean).join(" "), children: [
         /* @__PURE__ */ u3("div", { class: "profiler-query-card__header", children: [
-          /* @__PURE__ */ u3("span", { class: "profiler-text--muted", children: [
-            "#",
-            index + 1
+          /* @__PURE__ */ u3("div", { class: "profiler-flex profiler-flex--gap-2", children: [
+            /* @__PURE__ */ u3("span", { class: "profiler-text--muted", children: [
+              "#",
+              index + 1
+            ] }),
+            n1IndexSet.has(index) && /* @__PURE__ */ u3("span", { class: "profiler-badge profiler-badge--warning", children: "N+1" }),
+            query.name && /* @__PURE__ */ u3("span", { class: "profiler-text--xs profiler-text--muted", children: query.name })
           ] }),
-          /* @__PURE__ */ u3("span", { class: `profiler-query-card__duration ${query.slow ? "profiler-query-card__duration--slow" : "profiler-query-card__duration--fast"}`, children: [
-            query.duration.toFixed(2),
-            " ms"
+          /* @__PURE__ */ u3("div", { class: "profiler-flex profiler-flex--gap-2", children: [
+            /* @__PURE__ */ u3("span", { class: `profiler-query-card__duration ${query.slow ? "profiler-query-card__duration--slow" : "profiler-query-card__duration--fast"}`, children: [
+              query.duration.toFixed(2),
+              " ms"
+            ] }),
+            !query.cached && !query.transaction && /* @__PURE__ */ u3("button", { class: "profiler-btn profiler-btn--sm", onClick: () => runExplain(index), children: "Explain" })
           ] })
         ] }),
         /* @__PURE__ */ u3("code", { class: "profiler-query-card__code", children: query.sql })
-      ] }, index))
+      ] }, index)),
+      /* @__PURE__ */ u3(ExplainModal, { state: explainState, onClose: closeExplain })
     ] });
   }
 
@@ -1382,6 +1668,7 @@
       this.dpr = 1;
       this.hoveredFrame = null;
       this.zoomStack = [];
+      this.searchQuery = "";
       this.isPanning = false;
       this.panStartX = 0;
       this.panStartViewport = { start: 0, end: 0 };
@@ -1604,6 +1891,10 @@
         this.render();
       }
     }
+    setSearchQuery(query) {
+      this.searchQuery = query;
+      this.render();
+    }
     render() {
       const ctx = this.ctx;
       const w3 = this.canvas.width / this.dpr;
@@ -1613,6 +1904,15 @@
       const style = getComputedStyle(this.canvas);
       const textColor = style.getPropertyValue("--profiler-text").trim() || "#eef2f7";
       const textMuted = style.getPropertyValue("--profiler-text-muted").trim() || "#5e7080";
+      const searchLower = this.searchQuery.toLowerCase();
+      const hasSearch = searchLower.length > 0;
+      if (hasSearch && this.callbacks.onSearchResults) {
+        let matchCount = 0;
+        for (const f4 of this.frames) {
+          if (f4.node.name.toLowerCase().includes(searchLower)) matchCount++;
+        }
+        this.callbacks.onSearchResults(matchCount, this.frames.length);
+      }
       for (const frame of this.frames) {
         const x2 = (frame.absStart - this.viewport.start) / vpRange * w3;
         const fw = (frame.absEnd - frame.absStart) / vpRange * w3;
@@ -1620,8 +1920,9 @@
         if (x2 + fw < 0 || x2 > w3 || fw < 0.5) continue;
         const color = CATEGORY_COLORS[frame.node.category] || "#a78bfa";
         const isHovered = frame === this.hoveredFrame;
+        const isMatch = !hasSearch || frame.node.name.toLowerCase().includes(searchLower);
         ctx.fillStyle = isHovered ? this.lightenColor(color, 0.2) : color;
-        ctx.globalAlpha = isHovered ? 1 : 0.85;
+        ctx.globalAlpha = hasSearch && !isMatch ? 0.2 : isHovered ? 1 : 0.85;
         this.roundRect(ctx, x2, y3, fw, FRAME_HEIGHT, 3);
         ctx.fill();
         ctx.globalAlpha = 1;
@@ -1630,8 +1931,15 @@
           ctx.lineWidth = 1.5;
           this.roundRect(ctx, x2, y3, fw, FRAME_HEIGHT, 3);
           ctx.stroke();
+        } else if (hasSearch && isMatch) {
+          ctx.strokeStyle = "#ffffff";
+          ctx.lineWidth = 1;
+          ctx.globalAlpha = 0.5;
+          this.roundRect(ctx, x2, y3, fw, FRAME_HEIGHT, 3);
+          ctx.stroke();
+          ctx.globalAlpha = 1;
         }
-        if (fw > MIN_TEXT_WIDTH) {
+        if (fw > MIN_TEXT_WIDTH && isMatch) {
           ctx.fillStyle = this.getTextColor(color);
           ctx.font = '11px "JetBrains Mono", monospace';
           ctx.textBaseline = "middle";
@@ -1856,7 +2164,11 @@
     const rendererRef = A2(null);
     const tooltipRef = A2(null);
     const breadcrumbsRef = A2(null);
+    const searchInputRef = A2(null);
     const [isZoomed, setIsZoomed] = d2(false);
+    const [searchQuery, setSearchQuery] = d2("");
+    const [matchCount, setMatchCount] = d2(0);
+    const [totalCount, setTotalCount] = d2(0);
     const data = flamegraphData;
     y2(() => {
       if (!data?.root_events?.length || !canvasRef.current || !containerRef.current) return;
@@ -1888,6 +2200,10 @@
         onZoomChange: (ancestors) => {
           breadcrumbs.update(ancestors);
           setIsZoomed(ancestors.length > 0);
+        },
+        onSearchResults: (match, total) => {
+          setMatchCount(match);
+          setTotalCount(total);
         }
       });
       rendererRef.current = renderer;
@@ -1906,6 +2222,23 @@
         breadcrumbsRef.current = null;
       };
     }, [data]);
+    y2(() => {
+      rendererRef.current?.setSearchQuery(searchQuery);
+      if (!searchQuery) {
+        setMatchCount(0);
+        setTotalCount(0);
+      }
+    }, [searchQuery]);
+    y2(() => {
+      const onKeyDown = (e3) => {
+        if ((e3.ctrlKey || e3.metaKey) && e3.key === "f") {
+          e3.preventDefault();
+          searchInputRef.current?.focus();
+        }
+      };
+      document.addEventListener("keydown", onKeyDown, { capture: true });
+      return () => document.removeEventListener("keydown", onKeyDown, { capture: true });
+    }, []);
     if (!data?.root_events?.length) {
       if (!perfData?.events?.length) {
         return /* @__PURE__ */ u3("div", { class: "profiler-empty", children: /* @__PURE__ */ u3("p", { class: "profiler-empty__description", children: "No performance events recorded" }) });
@@ -1976,6 +2309,24 @@
       ] }, cat)) }),
       /* @__PURE__ */ u3("div", { class: "profiler-flamegraph__controls", children: [
         isZoomed && /* @__PURE__ */ u3("button", { class: "profiler-flamegraph__reset", onClick: handleReset, children: "Reset Zoom" }),
+        /* @__PURE__ */ u3("div", { class: "profiler-flamegraph__search", children: [
+          /* @__PURE__ */ u3(
+            "input",
+            {
+              ref: searchInputRef,
+              type: "text",
+              class: "profiler-flamegraph__search-input",
+              placeholder: "Search events\u2026 (Ctrl+F)",
+              value: searchQuery,
+              onInput: (e3) => setSearchQuery(e3.target.value)
+            }
+          ),
+          searchQuery && /* @__PURE__ */ u3("span", { class: "profiler-flamegraph__match-count", children: [
+            matchCount,
+            " / ",
+            totalCount
+          ] })
+        ] }),
         /* @__PURE__ */ u3("span", { class: "profiler-flamegraph__hint", children: "Click to zoom, scroll to zoom in/out, drag to pan" })
       ] }),
       /* @__PURE__ */ u3("div", { class: "profiler-flamegraph__canvas-container", ref: containerRef, children: /* @__PURE__ */ u3(
@@ -2545,7 +2896,7 @@
           activeTab === "exception" && /* @__PURE__ */ u3(ExceptionTab, { exceptionData: cd["exception"] }),
           activeTab === "request" && /* @__PURE__ */ u3(RequestTab, { profile }),
           activeTab === "dump" && /* @__PURE__ */ u3(DumpsTab, { dumpData: cd["dump"] }),
-          activeTab === "database" && /* @__PURE__ */ u3(DatabaseTab, { dbData: cd["database"] }),
+          activeTab === "database" && /* @__PURE__ */ u3(DatabaseTab, { dbData: cd["database"], token: profile.token }),
           activeTab === "ajax" && /* @__PURE__ */ u3(AjaxTab, { ajaxData: cd["ajax"] }),
           activeTab === "http" && /* @__PURE__ */ u3(HttpTab, { httpData: cd["http"] }),
           activeTab === "timeline" && /* @__PURE__ */ u3(FlameGraphTab, { flamegraphData: cd["flamegraph"], perfData: cd["performance"] }),

data/app/controllers/profiler/api/explain_controller.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "profiler/explain_runner"
+
+module Profiler
+  module Api
+    class ExplainController < ApplicationController
+      skip_before_action :verify_authenticity_token
+
+      def create
+        unless Profiler.configuration.enabled
+          return render json: { error: "EXPLAIN is only available when the profiler is enabled" }, status: :forbidden
+        end
+
+        token       = params[:token].to_s
+        query_index = params[:query_index].to_i
+
+        if token.blank?
+          return render json: { error: "token is required" }, status: :unprocessable_entity
+        end
+
+        result = Profiler::ExplainRunner.run(token, query_index)
+        render json: result
+      rescue ArgumentError => e
+        render json: { error: e.message }, status: :unprocessable_entity
+      rescue => e
+        render json: { error: e.message }, status: :internal_server_error
+      end
+    end
+  end
+end

data/config/routes.rb

@@ -32,5 +32,6 @@ Profiler::Engine.routes.draw do
     resources :outbound_http, only: [:index]
     get "toolbar/:token", to: "toolbar#show"
     post "ajax/link", to: "ajax#link"
+    post "explain", to: "explain#create"
   end
 end

data/lib/profiler/explain_runner.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Profiler
+  # Shared service for running EXPLAIN ANALYZE on a stored query.
+  # Used by both the HTTP API controller and the MCP explain_query tool.
+  module ExplainRunner
+    # @param profile_token [String]
+    # @param query_index   [Integer]
+    # @return [Hash] { result:, format: "json"|"text", adapter: String }
+    #         or raises ArgumentError / RuntimeError
+    def self.run(profile_token, query_index)
+      unless Profiler.configuration.enabled
+        raise SecurityError, "EXPLAIN is only available when the profiler is enabled"
+      end
+
+      profile = Profiler.storage.load(profile_token)
+      raise ArgumentError, "Profile not found: #{profile_token}" unless profile
+
+      db_data = profile.collector_data("database")
+      raise ArgumentError, "No database data in this profile" unless db_data && db_data["queries"]
+
+      queries = db_data["queries"]
+      query_index = query_index.to_i
+      unless query_index >= 0 && query_index < queries.size
+        raise ArgumentError, "Query index #{query_index} out of range (0..#{queries.size - 1})"
+      end
+
+      query = queries[query_index]
+      sql   = query["sql"].to_s
+      binds = Array(query["binds"])
+
+      conn    = ActiveRecord::Base.connection
+      adapter = conn.adapter_name.downcase
+      full_sql = reconstruct_sql(sql, binds, conn, adapter)
+
+      explain_sql, format = build_explain_statement(full_sql, adapter)
+
+      rows = conn.exec_query(explain_sql, "EXPLAIN").to_a
+
+      result = if format == "json"
+        # PostgreSQL / MySQL return JSON in rows[0]["QUERY PLAN"] or rows[0]["EXPLAIN"]
+        raw = rows.first&.values&.first.to_s
+        JSON.parse(raw) rescue raw
+      else
+        rows.map { |r| r.values.join("\t") }.join("\n")
+      end
+
+      { result: result, format: format, adapter: adapter }
+    end
+
+    private
+
+    def self.reconstruct_sql(sql, binds, conn, adapter)
+      return sql if binds.empty?
+
+      if adapter.include?("postgresql")
+        result = sql.dup
+        binds.each_with_index do |value, i|
+          result = result.gsub("$#{i + 1}", conn.quote(value))
+        end
+        result
+      else
+        # MySQL / SQLite: replace ? sequentially
+        result = sql.dup
+        binds.each do |value|
+          result = result.sub("?", conn.quote(value))
+        end
+        result
+      end
+    end
+
+    def self.build_explain_statement(sql, adapter)
+      if adapter.include?("postgresql")
+        ["EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON) #{sql}", "json"]
+      elsif adapter.include?("mysql")
+        ["EXPLAIN FORMAT=JSON #{sql}", "json"]
+      else
+        ["EXPLAIN QUERY PLAN #{sql}", "text"]
+      end
+    end
+  end
+end

data/lib/profiler/mcp/resources/n1_patterns.rb

@@ -14,15 +14,15 @@ module Profiler
             db_data = profile.collector_data("database")
             next unless db_data && db_data["queries"]
 
-            query_counts = db_data["queries"].group_by { |q| normalize_sql(q["sql"]) }
-                                             .transform_values(&:count)
+            query_groups = db_data["queries"].group_by { |q| normalize_sql(q["sql"]) }
 
-            query_counts.each do |normalized_sql, count|
+            query_groups.each do |normalized_sql, queries|
               pattern_map[normalized_sql] << {
                 token: profile.token,
                 path: profile.path,
-                count: count,
-                timestamp: profile.started_at&.iso8601
+                count: queries.size,
+                timestamp: profile.started_at&.iso8601,
+                backtrace: (queries.first["backtrace"] || []).first(3)
               }
             end
           end
@@ -35,7 +35,8 @@ module Profiler
           # Sort by total occurrence count descending
           sorted = n1_patterns.map do |sql, occurrences|
             total = occurrences.sum { |o| o[:count] }
-            { sql: sql, total_occurrences: total, profiles: occurrences }
+            sample_backtrace = occurrences.find { |o| o[:backtrace].any? }&.dig(:backtrace) || []
+            { sql: sql, total_occurrences: total, backtrace: sample_backtrace, profiles: occurrences }
           end.sort_by { |p| -p[:total_occurrences] }.first(20)
 
           {

data/lib/profiler/mcp/server.rb

@@ -65,6 +65,7 @@ module Profiler
         require_relative "tools/query_profiles"
         require_relative "tools/get_profile_detail"
         require_relative "tools/analyze_queries"
+        require_relative "tools/explain_query"
         require_relative "tools/get_profile_ajax"
         require_relative "tools/get_profile_dumps"
         require_relative "tools/get_profile_http"
@@ -116,6 +117,18 @@ module Profiler
             },
             handler: Tools::AnalyzeQueries
           ),
+          define_tool(
+            name: "explain_query",
+            description: "Run EXPLAIN ANALYZE on a specific query from a profile. Returns the query execution plan with cost and row estimates. Only available in development/test environments.",
+            input_schema: {
+              properties: {
+                token: { type: "string", description: "Profile token, or 'latest' for the most recent profile (required)" },
+                query_index: { type: "integer", description: "Zero-based index of the query within the profile's database queries list (required)" }
+              },
+              required: ["token", "query_index"]
+            },
+            handler: Tools::ExplainQuery
+          ),
           define_tool(
             name: "get_profile_ajax",
             description: "Get detailed AJAX sub-request breakdown for a profile. Use 'latest' as token to get the most recent profile.",

data/lib/profiler/mcp/tools/analyze_queries.rb

@@ -59,8 +59,8 @@ module Profiler
           slow_threshold = Profiler.configuration.slow_query_threshold
           slow_queries = queries.select { |q| q["duration"] > slow_threshold }
           query_counts = queries.group_by { |q| normalize_sql(q["sql"]) }
-                               .transform_values(&:count)
-                               .select { |_, count| count > 1 }
+                               .transform_values { |qs| { count: qs.size, backtrace: qs.first["backtrace"] || [] } }
+                               .select { |_, v| v[:count] >= 3 }
 
           unless summary_only
             # Detect slow queries
@@ -81,22 +81,27 @@ module Profiler
               lines << "All queries executed in less than #{slow_threshold}ms\n"
             end
 
-            # Detect duplicate queries (potential N+1)
+            # Detect duplicate queries (potential N+1, threshold: ≥ 3 occurrences)
             if query_counts.any?
               lines << "## ⚠️ Duplicate Queries (Potential N+1)"
-              lines << "Found #{query_counts.size} duplicate query patterns:\n"
+              lines << "Found #{query_counts.size} query pattern(s) repeated 3+ times:\n"
 
-              query_counts.sort_by { |_, count| -count }.first(5).each do |sql, count|
-                lines << "### Executed #{count} times:"
+              query_counts.sort_by { |_, v| -v[:count] }.first(5).each do |sql, v|
+                lines << "### Executed #{v[:count]} times:"
                 lines << "```sql"
                 lines << sql
-                lines << "```\n"
+                lines << "```"
+                if v[:backtrace].any?
+                  lines << "#### Called from:"
+                  v[:backtrace].first(3).each { |frame| lines << "  #{frame}" }
+                end
+                lines << ""
               end
 
               lines << "_... and #{query_counts.size - 5} more duplicate patterns_\n" if query_counts.size > 5
             else
               lines << "## ✅ No Duplicate Queries"
-              lines << "No potential N+1 query problems detected\n"
+              lines << "No query pattern repeated 3+ times\n"
             end
           end
 
@@ -106,7 +111,7 @@ module Profiler
           lines << "- **Total Duration:** #{queries.sum { |q| q['duration'] }.round(2)}ms"
           lines << "- **Average Duration:** #{(queries.sum { |q| q['duration'] } / queries.size).round(2)}ms"
           lines << "- **Slow Queries:** #{slow_queries.size}"
-          lines << "- **Duplicate Patterns:** #{query_counts.size}"
+          lines << "- **N+1 Patterns (≥3×):** #{query_counts.size}"
           lines << "- **Cached Queries:** #{queries.count { |q| q['cached'] }}"
 
           lines.join("\n")

data/lib/profiler/mcp/tools/explain_query.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "profiler/explain_runner"
+
+module Profiler
+  module MCP
+    module Tools
+      class ExplainQuery
+        def self.call(params)
+          token       = params["token"]
+          query_index = params["query_index"]
+
+          unless token
+            return [{ type: "text", text: "Error: token parameter is required" }]
+          end
+
+          if query_index.nil?
+            return [{ type: "text", text: "Error: query_index parameter is required" }]
+          end
+
+          unless Profiler.configuration.enabled
+            return [{ type: "text", text: "Error: EXPLAIN is only available when the profiler is enabled" }]
+          end
+
+          data = Profiler::ExplainRunner.run(token, query_index.to_i)
+
+          lines = []
+          lines << "# EXPLAIN ANALYZE — Query ##{query_index}"
+          lines << "Adapter: `#{data[:adapter]}`\n"
+
+          if data[:format] == "json"
+            lines << "```json"
+            lines << JSON.pretty_generate(data[:result])
+            lines << "```"
+          else
+            lines << "```"
+            lines << data[:result].to_s
+            lines << "```"
+          end
+
+          [{ type: "text", text: lines.join("\n") }]
+        rescue ArgumentError => e
+          [{ type: "text", text: "Error: #{e.message}" }]
+        rescue => e
+          [{ type: "text", text: "EXPLAIN failed: #{e.message}" }]
+        end
+      end
+    end
+  end
+end

data/lib/profiler/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-profiler
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Sébastien Duplessy
@@ -107,6 +107,7 @@ files:
 - app/assets/builds/profiler.css
 - app/assets/builds/profiler.js
 - app/controllers/profiler/api/ajax_controller.rb
+- app/controllers/profiler/api/explain_controller.rb
 - app/controllers/profiler/api/jobs_controller.rb
 - app/controllers/profiler/api/outbound_http_controller.rb
 - app/controllers/profiler/api/profiles_controller.rb
@@ -138,6 +139,7 @@ files:
 - lib/profiler/collectors/view_collector.rb
 - lib/profiler/configuration.rb
 - lib/profiler/engine.rb
+- lib/profiler/explain_runner.rb
 - lib/profiler/instrumentation/active_job_instrumentation.rb
 - lib/profiler/instrumentation/net_http_instrumentation.rb
 - lib/profiler/instrumentation/sidekiq_middleware.rb
@@ -152,6 +154,7 @@ files:
 - lib/profiler/mcp/server.rb
 - lib/profiler/mcp/tools/analyze_queries.rb
 - lib/profiler/mcp/tools/clear_profiles.rb
+- lib/profiler/mcp/tools/explain_query.rb
 - lib/profiler/mcp/tools/get_profile_ajax.rb
 - lib/profiler/mcp/tools/get_profile_detail.rb
 - lib/profiler/mcp/tools/get_profile_dumps.rb