postgresai 0.14.0-dev.42 → 0.14.0-dev.44

package/lib/checkup.ts

@@ -0,0 +1,833 @@
+/**
+ * Express Checkup Module
+ * ======================
+ * Generates JSON health check reports directly from PostgreSQL without Prometheus.
+ * 
+ * ARCHITECTURAL DECISIONS
+ * -----------------------
+ * 
+ * 1. SINGLE SOURCE OF TRUTH FOR SQL QUERIES
+ *    All SQL queries MUST be loaded from config/pgwatch-prometheus/metrics.yml
+ *    via getMetricSql() from metrics-loader.ts.
+ * 
+ *    DO NOT copy-paste or inline SQL queries in this file!
+ * 
+ *    The metrics.yml file is the single source of truth for metric extraction
+ *    logic, shared between:
+ *    - Full-fledged monitoring (Prometheus/pgwatch)
+ *    - Express checkup (this CLI tool)
+ * 
+ *    This ensures consistency and avoids maintenance burden of duplicate queries.
+ * 
+ * 2. JSON SCHEMA COMPLIANCE
+ *    All generated reports MUST comply with JSON schemas in reporter/schemas/.
+ *    These schemas define the expected format for both:
+ *    - Full-fledged monitoring reporter output
+ *    - Express checkup output
+ * 
+ *    Before adding or modifying a report, verify the corresponding schema exists
+ *    and ensure the output matches. Run schema validation tests to confirm.
+ * 
+ * ADDING NEW REPORTS
+ * ------------------
+ * 1. Add/verify the metric exists in config/pgwatch-prometheus/metrics.yml
+ * 2. Add the metric name mapping to METRIC_NAMES in metrics-loader.ts
+ * 3. Verify JSON schema exists in reporter/schemas/{CHECK_ID}.schema.json
+ * 4. Implement the generator function using getMetricSql()
+ * 5. Add schema validation test in test/schema-validation.test.ts
+ */
+
+import { Client } from "pg";
+import * as fs from "fs";
+import * as path from "path";
+import * as pkg from "../package.json";
+import { getMetricSql, transformMetricRow, METRIC_NAMES } from "./metrics-loader";
+
+/**
+ * PostgreSQL version information
+ */
+export interface PostgresVersion {
+  version: string;
+  server_version_num: string;
+  server_major_ver: string;
+  server_minor_ver: string;
+}
+
+/**
+ * Setting information from pg_settings
+ */
+export interface SettingInfo {
+  setting: string;
+  unit: string;
+  category: string;
+  context: string;
+  vartype: string;
+  pretty_value: string;
+}
+
+/**
+ * Altered setting (A007) - subset of SettingInfo
+ */
+export interface AlteredSetting {
+  value: string;
+  unit: string;
+  category: string;
+  pretty_value: string;
+}
+
+/**
+ * Cluster metric (A004)
+ */
+export interface ClusterMetric {
+  value: string;
+  unit: string;
+  description: string;
+}
+
+/**
+ * Invalid index entry (H001) - matches H001.schema.json invalidIndex
+ */
+export interface InvalidIndex {
+  schema_name: string;
+  table_name: string;
+  index_name: string;
+  relation_name: string;
+  index_size_bytes: number;
+  index_size_pretty: string;
+  supports_fk: boolean;
+}
+
+/**
+ * Unused index entry (H002) - matches H002.schema.json unusedIndex
+ */
+export interface UnusedIndex {
+  schema_name: string;
+  table_name: string;
+  index_name: string;
+  index_definition: string;
+  reason: string;
+  idx_scan: number;
+  index_size_bytes: number;
+  idx_is_btree: boolean;
+  supports_fk: boolean;
+  index_size_pretty: string;
+}
+
+/**
+ * Stats reset info for H002 - matches H002.schema.json statsReset
+ */
+export interface StatsReset {
+  stats_reset_epoch: number | null;
+  stats_reset_time: string | null;
+  days_since_reset: number | null;
+  postmaster_startup_epoch: number | null;
+  postmaster_startup_time: string | null;
+}
+
+/**
+ * Redundant index entry (H004) - matches H004.schema.json redundantIndex
+ */
+export interface RedundantIndex {
+  schema_name: string;
+  table_name: string;
+  index_name: string;
+  relation_name: string;
+  access_method: string;
+  reason: string;
+  index_size_bytes: number;
+  table_size_bytes: number;
+  index_usage: number;
+  supports_fk: boolean;
+  index_definition: string;
+  index_size_pretty: string;
+  table_size_pretty: string;
+}
+
+/**
+ * Node result for reports
+ */
+export interface NodeResult {
+  data: Record<string, any>;
+  postgres_version?: PostgresVersion;
+}
+
+/**
+ * Report structure matching JSON schemas
+ */
+export interface Report {
+  version: string | null;
+  build_ts: string | null;
+  checkId: string;
+  checkTitle: string;
+  timestamptz: string;
+  nodes: {
+    primary: string;
+    standbys: string[];
+  };
+  results: Record<string, NodeResult>;
+}
+
+/**
+ * Parse PostgreSQL version number into major and minor components
+ */
+export function parseVersionNum(versionNum: string): { major: string; minor: string } {
+  if (!versionNum || versionNum.length < 6) {
+    return { major: "", minor: "" };
+  }
+  try {
+    const num = parseInt(versionNum, 10);
+    return {
+      major: Math.floor(num / 10000).toString(),
+      minor: (num % 10000).toString(),
+    };
+  } catch {
+    return { major: "", minor: "" };
+  }
+}
+
+/**
+ * Format bytes to human readable string
+ */
+export function formatBytes(bytes: number): string {
+  if (bytes === 0) return "0 B";
+  const units = ["B", "kB", "MB", "GB", "TB", "PB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(1024));
+  return `${(bytes / Math.pow(1024, i)).toFixed(2)} ${units[i]}`;
+}
+
+/**
+ * Get PostgreSQL version information
+ * SQL loaded from config/pgwatch-prometheus/metrics.yml (express_version)
+ */
+export async function getPostgresVersion(client: Client): Promise<PostgresVersion> {
+  const sql = getMetricSql(METRIC_NAMES.version);
+  const result = await client.query(sql);
+
+  let version = "";
+  let serverVersionNum = "";
+
+  for (const row of result.rows) {
+    if (row.name === "server_version") {
+      version = row.setting;
+    } else if (row.name === "server_version_num") {
+      serverVersionNum = row.setting;
+    }
+  }
+
+  const { major, minor } = parseVersionNum(serverVersionNum);
+
+  return {
+    version,
+    server_version_num: serverVersionNum,
+    server_major_ver: major,
+    server_minor_ver: minor,
+  };
+}
+
+/**
+ * Get all PostgreSQL settings
+ * SQL loaded from config/pgwatch-prometheus/metrics.yml (express_settings)
+ */
+export async function getSettings(client: Client): Promise<Record<string, SettingInfo>> {
+  const sql = getMetricSql(METRIC_NAMES.settings);
+  const result = await client.query(sql);
+  const settings: Record<string, SettingInfo> = {};
+
+  for (const row of result.rows) {
+    settings[row.name] = {
+      setting: row.setting,
+      unit: row.unit || "",
+      category: row.category,
+      context: row.context,
+      vartype: row.vartype,
+      pretty_value: row.pretty_value,
+    };
+  }
+
+  return settings;
+}
+
+/**
+ * Get altered (non-default) PostgreSQL settings
+ * SQL loaded from config/pgwatch-prometheus/metrics.yml (express_altered_settings)
+ */
+export async function getAlteredSettings(client: Client): Promise<Record<string, AlteredSetting>> {
+  const sql = getMetricSql(METRIC_NAMES.alteredSettings);
+  const result = await client.query(sql);
+  const settings: Record<string, AlteredSetting> = {};
+
+  for (const row of result.rows) {
+    settings[row.name] = {
+      value: row.setting,
+      unit: row.unit || "",
+      category: row.category,
+      pretty_value: row.pretty_value,
+    };
+  }
+
+  return settings;
+}
+
+/**
+ * Get database sizes
+ * SQL loaded from config/pgwatch-prometheus/metrics.yml (express_database_sizes)
+ */
+export async function getDatabaseSizes(client: Client): Promise<Record<string, number>> {
+  const sql = getMetricSql(METRIC_NAMES.databaseSizes);
+  const result = await client.query(sql);
+  const sizes: Record<string, number> = {};
+
+  for (const row of result.rows) {
+    sizes[row.datname] = parseInt(row.size_bytes, 10);
+  }
+
+  return sizes;
+}
+
+/**
+ * Get cluster general info metrics
+ * SQL loaded from config/pgwatch-prometheus/metrics.yml (express_cluster_stats, express_connection_states, express_uptime)
+ */
+export async function getClusterInfo(client: Client): Promise<Record<string, ClusterMetric>> {
+  const info: Record<string, ClusterMetric> = {};
+
+  // Get cluster statistics
+  const clusterStatsSql = getMetricSql(METRIC_NAMES.clusterStats);
+  const statsResult = await client.query(clusterStatsSql);
+  if (statsResult.rows.length > 0) {
+    const stats = statsResult.rows[0];
+
+    info.total_connections = {
+      value: String(stats.total_connections || 0),
+      unit: "connections",
+      description: "Total active database connections",
+    };
+
+    info.total_commits = {
+      value: String(stats.total_commits || 0),
+      unit: "transactions",
+      description: "Total committed transactions",
+    };
+
+    info.total_rollbacks = {
+      value: String(stats.total_rollbacks || 0),
+      unit: "transactions",
+      description: "Total rolled back transactions",
+    };
+
+    const blocksHit = parseInt(stats.blocks_hit || "0", 10);
+    const blocksRead = parseInt(stats.blocks_read || "0", 10);
+    const totalBlocks = blocksHit + blocksRead;
+    const cacheHitRatio = totalBlocks > 0 ? ((blocksHit / totalBlocks) * 100).toFixed(2) : "0.00";
+
+    info.cache_hit_ratio = {
+      value: cacheHitRatio,
+      unit: "%",
+      description: "Buffer cache hit ratio",
+    };
+
+    info.blocks_read = {
+      value: String(blocksRead),
+      unit: "blocks",
+      description: "Total disk blocks read",
+    };
+
+    info.blocks_hit = {
+      value: String(blocksHit),
+      unit: "blocks",
+      description: "Total buffer cache hits",
+    };
+
+    info.tuples_returned = {
+      value: String(stats.tuples_returned || 0),
+      unit: "rows",
+      description: "Total rows returned by queries",
+    };
+
+    info.tuples_fetched = {
+      value: String(stats.tuples_fetched || 0),
+      unit: "rows",
+      description: "Total rows fetched by queries",
+    };
+
+    info.tuples_inserted = {
+      value: String(stats.tuples_inserted || 0),
+      unit: "rows",
+      description: "Total rows inserted",
+    };
+
+    info.tuples_updated = {
+      value: String(stats.tuples_updated || 0),
+      unit: "rows",
+      description: "Total rows updated",
+    };
+
+    info.tuples_deleted = {
+      value: String(stats.tuples_deleted || 0),
+      unit: "rows",
+      description: "Total rows deleted",
+    };
+
+    info.total_deadlocks = {
+      value: String(stats.total_deadlocks || 0),
+      unit: "deadlocks",
+      description: "Total deadlocks detected",
+    };
+
+    info.temp_files_created = {
+      value: String(stats.temp_files_created || 0),
+      unit: "files",
+      description: "Total temporary files created",
+    };
+
+    const tempBytes = parseInt(stats.temp_bytes_written || "0", 10);
+    info.temp_bytes_written = {
+      value: formatBytes(tempBytes),
+      unit: "bytes",
+      description: "Total temporary file bytes written",
+    };
+  }
+
+  // Get connection states
+  const connStatesSql = getMetricSql(METRIC_NAMES.connectionStates);
+  const connResult = await client.query(connStatesSql);
+  for (const row of connResult.rows) {
+    const stateKey = `connections_${row.state.replace(/\s+/g, "_")}`;
+    info[stateKey] = {
+      value: String(row.count),
+      unit: "connections",
+      description: `Connections in '${row.state}' state`,
+    };
+  }
+
+  // Get uptime info
+  const uptimeSql = getMetricSql(METRIC_NAMES.uptimeInfo);
+  const uptimeResult = await client.query(uptimeSql);
+  if (uptimeResult.rows.length > 0) {
+    const uptime = uptimeResult.rows[0];
+    info.start_time = {
+      value: uptime.start_time.toISOString(),
+      unit: "timestamp",
+      description: "PostgreSQL server start time",
+    };
+    info.uptime = {
+      value: uptime.uptime,
+      unit: "interval",
+      description: "Server uptime",
+    };
+  }
+
+  return info;
+}
+
+/**
+ * Get invalid indexes (H001)
+ * SQL loaded from config/pgwatch-prometheus/metrics.yml (pg_invalid_indexes)
+ */
+export async function getInvalidIndexes(client: Client): Promise<InvalidIndex[]> {
+  const sql = getMetricSql(METRIC_NAMES.H001);
+  const result = await client.query(sql);
+  return result.rows.map((row) => {
+    const transformed = transformMetricRow(row);
+    const indexSizeBytes = parseInt(String(transformed.index_size_bytes || 0), 10);
+    return {
+      schema_name: String(transformed.schema_name || ""),
+      table_name: String(transformed.table_name || ""),
+      index_name: String(transformed.index_name || ""),
+      relation_name: String(transformed.relation_name || ""),
+      index_size_bytes: indexSizeBytes,
+      index_size_pretty: formatBytes(indexSizeBytes),
+      supports_fk: transformed.supports_fk === true || transformed.supports_fk === 1,
+    };
+  });
+}
+
+/**
+ * Get unused indexes (H002)
+ * SQL loaded from config/pgwatch-prometheus/metrics.yml (unused_indexes)
+ */
+export async function getUnusedIndexes(client: Client): Promise<UnusedIndex[]> {
+  const sql = getMetricSql(METRIC_NAMES.H002);
+  const result = await client.query(sql);
+  return result.rows.map((row) => {
+    const transformed = transformMetricRow(row);
+    const indexSizeBytes = parseInt(String(transformed.index_size_bytes || 0), 10);
+    return {
+      schema_name: String(transformed.schema_name || ""),
+      table_name: String(transformed.table_name || ""),
+      index_name: String(transformed.index_name || ""),
+      index_definition: String(transformed.index_definition || ""),
+      reason: String(transformed.reason || ""),
+      idx_scan: parseInt(String(transformed.idx_scan || 0), 10),
+      index_size_bytes: indexSizeBytes,
+      idx_is_btree: transformed.idx_is_btree === true || transformed.idx_is_btree === "t",
+      supports_fk: transformed.supports_fk === true || transformed.supports_fk === 1,
+      index_size_pretty: formatBytes(indexSizeBytes),
+    };
+  });
+}
+
+/**
+ * Get stats reset info (H002)
+ */
+/**
+ * Get stats reset info (H002)
+ * SQL loaded from config/pgwatch-prometheus/metrics.yml (express_stats_reset)
+ */
+export async function getStatsReset(client: Client): Promise<StatsReset> {
+  const sql = getMetricSql(METRIC_NAMES.statsReset);
+  const result = await client.query(sql);
+  const row = result.rows[0] || {};
+  return {
+    stats_reset_epoch: row.stats_reset_epoch ? parseFloat(row.stats_reset_epoch) : null,
+    stats_reset_time: row.stats_reset_time || null,
+    days_since_reset: row.days_since_reset ? parseInt(row.days_since_reset, 10) : null,
+    postmaster_startup_epoch: row.postmaster_startup_epoch ? parseFloat(row.postmaster_startup_epoch) : null,
+    postmaster_startup_time: row.postmaster_startup_time || null,
+  };
+}
+
+/**
+ * Get current database name and size
+ * SQL loaded from config/pgwatch-prometheus/metrics.yml (express_current_database)
+ */
+export async function getCurrentDatabaseInfo(client: Client): Promise<{ datname: string; size_bytes: number }> {
+  const sql = getMetricSql(METRIC_NAMES.currentDatabase);
+  const result = await client.query(sql);
+  const row = result.rows[0] || {};
+  return {
+    datname: row.datname || "postgres",
+    size_bytes: parseInt(row.size_bytes, 10) || 0,
+  };
+}
+
+/**
+ * Get redundant indexes (H004)
+ * SQL loaded from config/pgwatch-prometheus/metrics.yml (redundant_indexes)
+ */
+export async function getRedundantIndexes(client: Client): Promise<RedundantIndex[]> {
+  const sql = getMetricSql(METRIC_NAMES.H004);
+  const result = await client.query(sql);
+  return result.rows.map((row) => {
+    const transformed = transformMetricRow(row);
+    const indexSizeBytes = parseInt(String(transformed.index_size_bytes || 0), 10);
+    const tableSizeBytes = parseInt(String(transformed.table_size_bytes || 0), 10);
+    return {
+      schema_name: String(transformed.schema_name || ""),
+      table_name: String(transformed.table_name || ""),
+      index_name: String(transformed.index_name || ""),
+      relation_name: String(transformed.relation_name || ""),
+      access_method: String(transformed.access_method || ""),
+      reason: String(transformed.reason || ""),
+      index_size_bytes: indexSizeBytes,
+      table_size_bytes: tableSizeBytes,
+      index_usage: parseInt(String(transformed.index_usage || 0), 10),
+      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),
+    };
+  });
+}
+
+/**
+ * Create base report structure
+ */
+export function createBaseReport(
+  checkId: string,
+  checkTitle: string,
+  nodeName: string
+): Report {
+  const buildTs = resolveBuildTs();
+  return {
+    version: pkg.version || null,
+    build_ts: buildTs,
+    checkId,
+    checkTitle,
+    timestamptz: new Date().toISOString(),
+    nodes: {
+      primary: nodeName,
+      standbys: [],
+    },
+    results: {},
+  };
+}
+
+function readTextFileSafe(p: string): string | null {
+  try {
+    const value = fs.readFileSync(p, "utf8").trim();
+    return value || null;
+  } catch {
+    return null;
+  }
+}
+
+function resolveBuildTs(): string | null {
+  // Follow reporter.py approach: read BUILD_TS from filesystem, with env override.
+  // Default: /BUILD_TS (useful in container images).
+  const envPath = process.env.PGAI_BUILD_TS_FILE;
+  const p = (envPath && envPath.trim()) ? envPath.trim() : "/BUILD_TS";
+
+  const fromFile = readTextFileSafe(p);
+  if (fromFile) return fromFile;
+
+  // Fallback for packaged CLI: allow placing BUILD_TS next to dist/ (package root).
+  // dist/lib/checkup.js => package root: dist/..
+  try {
+    const pkgRoot = path.resolve(__dirname, "..");
+    const fromPkgFile = readTextFileSafe(path.join(pkgRoot, "BUILD_TS"));
+    if (fromPkgFile) return fromPkgFile;
+  } catch {
+    // ignore
+  }
+
+  // Last resort: use package.json mtime as an approximation (non-null, stable-ish).
+  try {
+    const pkgJsonPath = path.resolve(__dirname, "..", "package.json");
+    const st = fs.statSync(pkgJsonPath);
+    return st.mtime.toISOString();
+  } catch {
+    return new Date().toISOString();
+  }
+}
+
+/**
+ * Generate A002 report - Postgres major version
+ */
+export async function generateA002(client: Client, nodeName: string = "node-01"): Promise<Report> {
+  const report = createBaseReport("A002", "Postgres major version", nodeName);
+  const postgresVersion = await getPostgresVersion(client);
+
+  report.results[nodeName] = {
+    data: {
+      version: postgresVersion,
+    },
+  };
+
+  return report;
+}
+
+/**
+ * Generate A003 report - Postgres settings
+ */
+export async function generateA003(client: Client, nodeName: string = "node-01"): Promise<Report> {
+  const report = createBaseReport("A003", "Postgres settings", nodeName);
+  const settings = await getSettings(client);
+  const postgresVersion = await getPostgresVersion(client);
+
+  report.results[nodeName] = {
+    data: settings,
+    postgres_version: postgresVersion,
+  };
+
+  return report;
+}
+
+/**
+ * Generate A004 report - Cluster information
+ */
+export async function generateA004(client: Client, nodeName: string = "node-01"): Promise<Report> {
+  const report = createBaseReport("A004", "Cluster information", nodeName);
+  const generalInfo = await getClusterInfo(client);
+  const databaseSizes = await getDatabaseSizes(client);
+  const postgresVersion = await getPostgresVersion(client);
+
+  report.results[nodeName] = {
+    data: {
+      general_info: generalInfo,
+      database_sizes: databaseSizes,
+    },
+    postgres_version: postgresVersion,
+  };
+
+  return report;
+}
+
+/**
+ * Generate A007 report - Altered settings
+ */
+export async function generateA007(client: Client, nodeName: string = "node-01"): Promise<Report> {
+  const report = createBaseReport("A007", "Altered settings", nodeName);
+  const alteredSettings = await getAlteredSettings(client);
+  const postgresVersion = await getPostgresVersion(client);
+
+  report.results[nodeName] = {
+    data: alteredSettings,
+    postgres_version: postgresVersion,
+  };
+
+  return report;
+}
+
+/**
+ * Generate A013 report - Postgres minor version
+ */
+export async function generateA013(client: Client, nodeName: string = "node-01"): Promise<Report> {
+  const report = createBaseReport("A013", "Postgres minor version", nodeName);
+  const postgresVersion = await getPostgresVersion(client);
+
+  report.results[nodeName] = {
+    data: {
+      version: postgresVersion,
+    },
+  };
+
+  return report;
+}
+
+/**
+ * Generate H001 report - Invalid indexes
+ */
+export async function generateH001(client: Client, nodeName: string = "node-01"): Promise<Report> {
+  const report = createBaseReport("H001", "Invalid indexes", nodeName);
+  const invalidIndexes = await getInvalidIndexes(client);
+  const postgresVersion = await getPostgresVersion(client);
+  
+  // Get current database name and size
+  const { datname: dbName, size_bytes: dbSizeBytes } = await getCurrentDatabaseInfo(client);
+
+  // Calculate totals
+  const totalCount = invalidIndexes.length;
+  const totalSizeBytes = invalidIndexes.reduce((sum, idx) => sum + idx.index_size_bytes, 0);
+
+  // Structure data by database name per schema
+  report.results[nodeName] = {
+    data: {
+      [dbName]: {
+        invalid_indexes: invalidIndexes,
+        total_count: totalCount,
+        total_size_bytes: totalSizeBytes,
+        total_size_pretty: formatBytes(totalSizeBytes),
+        database_size_bytes: dbSizeBytes,
+        database_size_pretty: formatBytes(dbSizeBytes),
+      },
+    },
+    postgres_version: postgresVersion,
+  };
+
+  return report;
+}
+
+/**
+ * Generate H002 report - Unused indexes
+ */
+export async function generateH002(client: Client, nodeName: string = "node-01"): Promise<Report> {
+  const report = createBaseReport("H002", "Unused indexes", nodeName);
+  const unusedIndexes = await getUnusedIndexes(client);
+  const postgresVersion = await getPostgresVersion(client);
+  const statsReset = await getStatsReset(client);
+  
+  // Get current database name and size
+  const { datname: dbName, size_bytes: dbSizeBytes } = await getCurrentDatabaseInfo(client);
+
+  // Calculate totals
+  const totalCount = unusedIndexes.length;
+  const totalSizeBytes = unusedIndexes.reduce((sum, idx) => sum + idx.index_size_bytes, 0);
+
+  // Structure data by database name per schema
+  report.results[nodeName] = {
+    data: {
+      [dbName]: {
+        unused_indexes: unusedIndexes,
+        total_count: totalCount,
+        total_size_bytes: totalSizeBytes,
+        total_size_pretty: formatBytes(totalSizeBytes),
+        database_size_bytes: dbSizeBytes,
+        database_size_pretty: formatBytes(dbSizeBytes),
+        stats_reset: statsReset,
+      },
+    },
+    postgres_version: postgresVersion,
+  };
+
+  return report;
+}
+
+/**
+ * Generate H004 report - Redundant indexes
+ */
+export async function generateH004(client: Client, nodeName: string = "node-01"): Promise<Report> {
+  const report = createBaseReport("H004", "Redundant indexes", nodeName);
+  const redundantIndexes = await getRedundantIndexes(client);
+  const postgresVersion = await getPostgresVersion(client);
+  
+  // Get current database name and size
+  const { datname: dbName, size_bytes: dbSizeBytes } = await getCurrentDatabaseInfo(client);
+
+  // Calculate totals
+  const totalCount = redundantIndexes.length;
+  const totalSizeBytes = redundantIndexes.reduce((sum, idx) => sum + idx.index_size_bytes, 0);
+
+  // Structure data by database name per schema
+  report.results[nodeName] = {
+    data: {
+      [dbName]: {
+        redundant_indexes: redundantIndexes,
+        total_count: totalCount,
+        total_size_bytes: totalSizeBytes,
+        total_size_pretty: formatBytes(totalSizeBytes),
+        database_size_bytes: dbSizeBytes,
+        database_size_pretty: formatBytes(dbSizeBytes),
+      },
+    },
+    postgres_version: postgresVersion,
+  };
+
+  return report;
+}
+
+/**
+ * Available report generators
+ */
+export const REPORT_GENERATORS: Record<string, (client: Client, nodeName: string) => Promise<Report>> = {
+  A002: generateA002,
+  A003: generateA003,
+  A004: generateA004,
+  A007: generateA007,
+  A013: generateA013,
+  H001: generateH001,
+  H002: generateH002,
+  H004: generateH004,
+};
+
+/**
+ * Check IDs and titles
+ */
+export const CHECK_INFO: Record<string, string> = {
+  A002: "Postgres major version",
+  A003: "Postgres settings",
+  A004: "Cluster information",
+  A007: "Altered settings",
+  A013: "Postgres minor version",
+  H001: "Invalid indexes",
+  H002: "Unused indexes",
+  H004: "Redundant indexes",
+};
+
+/**
+ * Generate all available reports
+ */
+export async function generateAllReports(
+  client: Client,
+  nodeName: string = "node-01",
+  onProgress?: (info: { checkId: string; checkTitle: string; index: number; total: number }) => void
+): Promise<Record<string, Report>> {
+  const reports: Record<string, Report> = {};
+
+  const entries = Object.entries(REPORT_GENERATORS);
+  const total = entries.length;
+  let index = 0;
+
+  for (const [checkId, generator] of entries) {
+    index += 1;
+    onProgress?.({
+      checkId,
+      checkTitle: CHECK_INFO[checkId] || checkId,
+      index,
+      total,
+    });
+    reports[checkId] = await generator(client, nodeName);
+  }
+
+  return reports;
+}