postgresai 0.14.0-dev.49 → 0.14.0-dev.51

package/dist/bin/postgres-ai.js

@@ -13064,7 +13064,7 @@ var {
 // package.json
 var package_default = {
   name: "postgresai",
-  version: "0.14.0-dev.49",
+  version: "0.14.0-dev.51",
   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.49";
+var version = "0.14.0-dev.51";
 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
     };
   });
 }
@@ -24933,6 +24951,7 @@ function createBaseReport(checkId, checkTitle, nodeName) {
   return {
     version: version || null,
     build_ts: buildTs,
+    generation_mode: "express",
     checkId,
     checkTitle,
     timestamptz: new Date().toISOString(),

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[];
 }
 
 /**
@@ -157,6 +166,7 @@ export interface NodeResult {
 export interface Report {
   version: string | null;
   build_ts: string | null;
+  generation_mode: string | null;
   checkId: string;
   checkTitle: string;
   timestamptz: string;
@@ -516,6 +526,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 +556,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,
     };
   });
 }
@@ -546,6 +573,7 @@ export function createBaseReport(
   return {
     version: pkg.version || null,
     build_ts: buildTs,
+    generation_mode: "express",
     checkId,
     checkTitle,
     timestamptz: new Date().toISOString(),

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.49",
+  "version": "0.14.0-dev.51",
   "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)" }
+          ])
         },
       ],
     });