postgresai 0.14.0-dev.77 → 0.14.0-dev.78

package/bin/postgres-ai.ts

@@ -20,6 +20,7 @@ import { maskSecret } from "../lib/util";
 import { createInterface } from "readline";
 import * as childProcess from "child_process";
 import { REPORT_GENERATORS, CHECK_INFO, generateAllReports } from "../lib/checkup";
+import { getAllCheckupEntries, getCheckupEntry, isValidCheckupCode } from "../lib/checkup-dictionary";
 import { createCheckupReport, uploadCheckupReportJson, RpcError, formatRpcErrorForDisplay, withRetry } from "../lib/checkup-api";
 
 // Singleton readline interface for stdin prompts
@@ -1641,10 +1642,18 @@ program
     }
   });
 
+// Build help text showing all checks from dictionary with express-mode indicators
+const expressCheckIds = new Set(Object.keys(REPORT_GENERATORS));
+const allChecks = getAllCheckupEntries();
+const checkHelpLines = allChecks.map((entry) => {
+  const isExpress = expressCheckIds.has(entry.code);
+  return `  ${entry.code}: ${entry.title}${isExpress ? "" : " (*)"}`;
+});
+
 program
   .command("checkup [conn]")
   .description("generate health check reports directly from PostgreSQL (express mode)")
-  .option("--check-id <id>", `specific check to run: ${Object.keys(CHECK_INFO).join(", ")}, or ALL`, "ALL")
+  .option("--check-id <id>", `specific check to run (see list below), or ALL`, "ALL")
   .option("--node-name <name>", "node name for reports", "node-01")
   .option("--output <path>", "output directory for JSON files")
   .option("--[no-]upload", "upload JSON results to PostgresAI (default: enabled; requires API key)", undefined)
@@ -1658,7 +1667,10 @@ program
     [
       "",
       "Available checks:",
-      ...Object.entries(CHECK_INFO).map(([id, title]) => `  ${id}: ${title}`),
+      ...checkHelpLines,
+      "",
+      "  (*) = not yet available in express mode (coming soon)",
+      "  ALL = run all express-mode checks",
       "",
       "Examples:",
       "  postgresai checkup postgresql://user:pass@host:5432/db",
@@ -1725,8 +1737,16 @@ program
         const generator = REPORT_GENERATORS[checkId];
         if (!generator) {
           spinner.stop();
-          console.error(`Unknown check ID: ${opts.checkId}`);
-          console.error(`Available: ${Object.keys(CHECK_INFO).join(", ")}, ALL`);
+          // Check if it's a valid check ID from the dictionary (just not implemented in express mode)
+          const dictEntry = getCheckupEntry(checkId);
+          if (dictEntry) {
+            console.error(`Check ${checkId} (${dictEntry.title}) is not yet available in express mode.`);
+            console.error(`Express-mode checks: ${Object.keys(CHECK_INFO).join(", ")}`);
+            console.error(`\nFull checkup reports are available at: https://postgres.ai/checkup`);
+          } else {
+            console.error(`Unknown check ID: ${opts.checkId}`);
+            console.error(`See 'postgresai checkup --help' for available checks.`);
+          }
           process.exitCode = 1;
           return;
         }

package/dist/bin/postgres-ai.js

@@ -13064,7 +13064,7 @@ var {
 // package.json
 var package_default = {
   name: "postgresai",
-  version: "0.14.0-dev.77",
+  version: "0.14.0-dev.78",
   description: "postgres_ai CLI",
   license: "Apache-2.0",
   private: false,
@@ -15889,7 +15889,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.77";
+var version = "0.14.0-dev.78";
 var package_default2 = {
   name: "postgresai",
   version,
@@ -27895,6 +27895,15 @@ async function generateAllReports(client, nodeName = "node-01", onProgress) {
   return reports;
 }
 
+// lib/checkup-dictionary.ts
+var dictionaryByCode2 = new Map(CHECKUP_DICTIONARY_DATA.map((entry) => [entry.code, entry]));
+function getAllCheckupEntries() {
+  return CHECKUP_DICTIONARY_DATA;
+}
+function getCheckupEntry(code) {
+  return dictionaryByCode2.get(code.toUpperCase()) ?? null;
+}
+
 // lib/checkup-api.ts
 import * as https from "https";
 import { URL as URL3 } from "url";
@@ -29401,10 +29410,19 @@ program2.command("unprepare-db [conn]").description("remove monitoring setup: dr
     closeReadline();
   }
 });
-program2.command("checkup [conn]").description("generate health check reports directly from PostgreSQL (express mode)").option("--check-id <id>", `specific check to run: ${Object.keys(CHECK_INFO).join(", ")}, or ALL`, "ALL").option("--node-name <name>", "node name for reports", "node-01").option("--output <path>", "output directory for JSON files").option("--[no-]upload", "upload JSON results to PostgresAI (default: enabled; requires API key)", undefined).option("--project <project>", "project name or ID for remote upload (used with --upload; defaults to config defaultProject; auto-generated on first run)").option("--json", "output JSON to stdout (implies --no-upload)").addHelpText("after", [
+var expressCheckIds = new Set(Object.keys(REPORT_GENERATORS));
+var allChecks = getAllCheckupEntries();
+var checkHelpLines = allChecks.map((entry) => {
+  const isExpress = expressCheckIds.has(entry.code);
+  return `  ${entry.code}: ${entry.title}${isExpress ? "" : " (*)"}`;
+});
+program2.command("checkup [conn]").description("generate health check reports directly from PostgreSQL (express mode)").option("--check-id <id>", `specific check to run (see list below), or ALL`, "ALL").option("--node-name <name>", "node name for reports", "node-01").option("--output <path>", "output directory for JSON files").option("--[no-]upload", "upload JSON results to PostgresAI (default: enabled; requires API key)", undefined).option("--project <project>", "project name or ID for remote upload (used with --upload; defaults to config defaultProject; auto-generated on first run)").option("--json", "output JSON to stdout (implies --no-upload)").addHelpText("after", [
   "",
   "Available checks:",
-  ...Object.entries(CHECK_INFO).map(([id, title]) => `  ${id}: ${title}`),
+  ...checkHelpLines,
+  "",
+  "  (*) = not yet available in express mode (coming soon)",
+  "  ALL = run all express-mode checks",
   "",
   "Examples:",
   "  postgresai checkup postgresql://user:pass@host:5432/db",
@@ -29460,8 +29478,16 @@ program2.command("checkup [conn]").description("generate health check reports di
       const generator = REPORT_GENERATORS[checkId];
       if (!generator) {
         spinner.stop();
-        console.error(`Unknown check ID: ${opts.checkId}`);
-        console.error(`Available: ${Object.keys(CHECK_INFO).join(", ")}, ALL`);
+        const dictEntry = getCheckupEntry(checkId);
+        if (dictEntry) {
+          console.error(`Check ${checkId} (${dictEntry.title}) is not yet available in express mode.`);
+          console.error(`Express-mode checks: ${Object.keys(CHECK_INFO).join(", ")}`);
+          console.error(`
+Full checkup reports are available at: https://postgres.ai/checkup`);
+        } else {
+          console.error(`Unknown check ID: ${opts.checkId}`);
+          console.error(`See 'postgresai checkup --help' for available checks.`);
+        }
         process.exitCode = 1;
         return;
       }

package/package.json

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