postgresai 0.14.0-dev.48 → 0.14.0-dev.50

package/bun.lock

@@ -131,7 +131,7 @@
 
     "jose": ["jose@6.1.3", "", {}, "sha512-0TpaTfihd4QMNwrz/ob2Bp7X04yuxJkjRGi4aKmOqwhov54i6u79oCv7T+C7lo70MKH6BesI3vscD1yb/yzKXQ=="],
 
-    "js-yaml": ["js-yaml@4.1.1", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": "bin/js-yaml.js" }, "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA=="],
+    "js-yaml": ["js-yaml@4.1.1", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA=="],
 
     "json-schema-traverse": ["json-schema-traverse@1.0.0", "", {}, "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="],
 

package/dist/bin/postgres-ai.js

@@ -13064,7 +13064,7 @@ var {
 // package.json
 var package_default = {
   name: "postgresai",
-  version: "0.14.0-dev.48",
+  version: "0.14.0-dev.50",
   description: "postgres_ai CLI",
   license: "Apache-2.0",
   private: false,
@@ -15881,7 +15881,7 @@ var Result = import_lib.default.Result;
 var TypeOverrides = import_lib.default.TypeOverrides;
 var defaults = import_lib.default.defaults;
 // package.json
-var version = "0.14.0-dev.48";
+var version = "0.14.0-dev.50";
 var package_default2 = {
   name: "postgresai",
   version,
@@ -24599,7 +24599,13 @@ redundant_indexes_tmp_num as (
     formated_schema_name as tag_schema_name,
     formated_table_name as tag_table_name,
     formated_relation_name as tag_relation_name,
-    supports_fk::int as supports_fk
+    supports_fk::int as supports_fk,
+    json_agg(
+      distinct jsonb_build_object(
+        'index_name', reason,
+        'index_definition', main_index_def
+      )
+    )::text as covering_indexes_json
   from redundant_indexes_cut_grouped
   group by
     index_id,
@@ -24911,6 +24917,17 @@ async function getRedundantIndexes(client) {
     const transformed = transformMetricRow(row);
     const indexSizeBytes = parseInt(String(transformed.index_size_bytes || 0), 10);
     const tableSizeBytes = parseInt(String(transformed.table_size_bytes || 0), 10);
+    let coveringIndexes = [];
+    try {
+      const jsonStr = String(transformed.covering_indexes_json || "[]");
+      const parsed = JSON.parse(jsonStr);
+      if (Array.isArray(parsed)) {
+        coveringIndexes = parsed.map((item) => ({
+          index_name: String(item.index_name || ""),
+          index_definition: String(item.index_definition || "")
+        }));
+      }
+    } catch {}
     return {
       schema_name: String(transformed.schema_name || ""),
       table_name: String(transformed.table_name || ""),
@@ -24924,7 +24941,8 @@ async function getRedundantIndexes(client) {
       supports_fk: transformed.supports_fk === true || transformed.supports_fk === 1,
       index_definition: String(transformed.index_definition || ""),
       index_size_pretty: formatBytes(indexSizeBytes),
-      table_size_pretty: formatBytes(tableSizeBytes)
+      table_size_pretty: formatBytes(tableSizeBytes),
+      covering_indexes: coveringIndexes
     };
   });
 }

package/lib/checkup.ts

@@ -127,6 +127,14 @@ export interface StatsReset {
 /**
  * Redundant index entry (H004) - matches H004.schema.json redundantIndex
  */
+/**
+ * Covering index definition (the index that makes another index redundant)
+ */
+export interface CoveringIndex {
+  index_name: string;
+  index_definition: string;
+}
+
 export interface RedundantIndex {
   schema_name: string;
   table_name: string;
@@ -141,6 +149,7 @@ export interface RedundantIndex {
   index_definition: string;
   index_size_pretty: string;
   table_size_pretty: string;
+  covering_indexes: CoveringIndex[];
 }
 
 /**
@@ -516,6 +525,22 @@ export async function getRedundantIndexes(client: Client): Promise<RedundantInde
     const transformed = transformMetricRow(row);
     const indexSizeBytes = parseInt(String(transformed.index_size_bytes || 0), 10);
     const tableSizeBytes = parseInt(String(transformed.table_size_bytes || 0), 10);
+    
+    // Parse covering_indexes JSON array
+    let coveringIndexes: CoveringIndex[] = [];
+    try {
+      const jsonStr = String(transformed.covering_indexes_json || "[]");
+      const parsed = JSON.parse(jsonStr);
+      if (Array.isArray(parsed)) {
+        coveringIndexes = parsed.map((item: any) => ({
+          index_name: String(item.index_name || ""),
+          index_definition: String(item.index_definition || ""),
+        }));
+      }
+    } catch {
+      // If JSON parsing fails, leave as empty array
+    }
+    
     return {
       schema_name: String(transformed.schema_name || ""),
       table_name: String(transformed.table_name || ""),
@@ -530,6 +555,7 @@ export async function getRedundantIndexes(client: Client): Promise<RedundantInde
       index_definition: String(transformed.index_definition || ""),
       index_size_pretty: formatBytes(indexSizeBytes),
       table_size_pretty: formatBytes(tableSizeBytes),
+      covering_indexes: coveringIndexes,
     };
   });
 }

package/lib/metrics-loader.ts

@@ -418,7 +418,13 @@ redundant_indexes_tmp_num as (
     formated_schema_name as tag_schema_name,
     formated_table_name as tag_table_name,
     formated_relation_name as tag_relation_name,
-    supports_fk::int as supports_fk
+    supports_fk::int as supports_fk,
+    json_agg(
+      distinct jsonb_build_object(
+        'index_name', reason,
+        'index_definition', main_index_def
+      )
+    )::text as covering_indexes_json
   from redundant_indexes_cut_grouped
   group by
     index_id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postgresai",
-  "version": "0.14.0-dev.48",
+  "version": "0.14.0-dev.50",
   "description": "postgres_ai CLI",
   "license": "Apache-2.0",
   "private": false,

package/test/checkup.test.ts

@@ -840,6 +840,9 @@ describe("H004 - Redundant indexes", () => {
           index_usage: "0",
           supports_fk: false,
           index_definition: "CREATE INDEX orders_user_id_idx ON public.orders USING btree (user_id)",
+          covering_indexes_json: JSON.stringify([
+            { index_name: "public.orders_user_id_created_idx", index_definition: "CREATE INDEX orders_user_id_created_idx ON public.orders USING btree (user_id, created_at)" }
+          ]),
         },
       ],
     });
@@ -853,6 +856,11 @@ describe("H004 - Redundant indexes", () => {
     expect(indexes[0].supports_fk).toBe(false);
     expect(indexes[0].index_definition).toBeTruthy();
     expect(indexes[0].relation_name).toBe("orders");
+    // Verify covering_indexes is populated with definitions
+    expect(indexes[0].covering_indexes).toBeInstanceOf(Array);
+    expect(indexes[0].covering_indexes.length).toBe(1);
+    expect(indexes[0].covering_indexes[0].index_name).toBe("public.orders_user_id_created_idx");
+    expect(indexes[0].covering_indexes[0].index_definition).toContain("CREATE INDEX");
   });
 
   test("generateH004 creates report with redundant indexes", async () => {
@@ -876,6 +884,9 @@ describe("H004 - Redundant indexes", () => {
             index_usage: "5",
             supports_fk: false,
             index_definition: "CREATE INDEX products_category_idx ON public.products USING btree (category)",
+            covering_indexes_json: JSON.stringify([
+              { index_name: "public.products_category_name_idx", index_definition: "CREATE INDEX products_category_name_idx ON public.products USING btree (category, name)" }
+            ]),
           },
         ],
       }
@@ -919,6 +930,9 @@ describe("H004 - Redundant indexes", () => {
             index_usage: "5",
             supports_fk: false,
             index_definition: "CREATE INDEX products_category_idx ON public.products USING btree (category)",
+            covering_indexes_json: JSON.stringify([
+              { index_name: "public.products_category_name_idx", index_definition: "CREATE INDEX products_category_name_idx ON public.products USING btree (category, name)" }
+            ]),
           },
         ],
       }

package/test/schema-validation.test.ts

@@ -202,7 +202,10 @@ describe("H004 schema validation", () => {
           table_size_bytes: "16777216",
           index_usage: "0",
           supports_fk: false,
-          index_definition: "CREATE INDEX orders_user_id_idx ON public.orders USING btree (user_id)"
+          index_definition: "CREATE INDEX orders_user_id_idx ON public.orders USING btree (user_id)",
+          covering_indexes_json: JSON.stringify([
+            { index_name: "public.orders_user_id_created_idx", index_definition: "CREATE INDEX orders_user_id_created_idx ON public.orders USING btree (user_id, created_at)" }
+          ])
         },
       ],
     });