@indiekitai/pg-dash 0.4.2 → 0.4.4

package/README.md

@@ -4,6 +4,8 @@
 
 **The AI-native PostgreSQL health checker.** One command to audit your database, 23 MCP tools for AI-assisted optimization, CI integration for automated checks.
 
+📖 **[Read the full writeup on Dev.to](https://dev.to/fan_yang_670d82db29664c9e/i-built-a-free-postgresql-health-checker-with-23-mcp-tools-and-ci-integration-2abc)**
+
 Not another monitoring dashboard — pg-dash is built to fit into your **AI coding workflow**:
 
 ```
@@ -165,6 +167,13 @@ pg-dash --host localhost --user postgres --db mydb --port 3480
 
 Opens your browser at `http://localhost:3480` with the full dashboard.
 
+## Documentation
+
+- [Real-world example](docs/real-world-example.md) — pg-dash running against a production database
+- [Migration safety guide](docs/migration-safety.md) — catching lock risks before they hit production
+- [MCP setup guide](docs/mcp-setup.md) — connecting to Claude Desktop and Cursor
+- [CI integration guide](docs/ci-integration.md) — automated checks in GitHub Actions
+
 ## CLI Options
 
 ```

package/README.zh-CN.md

@@ -4,6 +4,8 @@
 
 **AI 原生的 PostgreSQL 健康检查工具。** 一条命令审计数据库，23 个 MCP 工具让 AI 帮你优化，CI 集成自动检查。
 
+📖 **[在 Dev.to 阅读完整介绍](https://dev.to/fan_yang_670d82db29664c9e/i-built-a-free-postgresql-health-checker-with-23-mcp-tools-and-ci-integration-2abc)**
+
 不是又一个监控面板 —— pg-dash 是为 **AI 编程工作流** 设计的：
 
 ```

package/dist/cli.js

@@ -4078,6 +4078,7 @@ pg-dash \u2014 Lightweight PostgreSQL Monitoring Dashboard
 Usage:
   pg-dash <connection-string>                           Start dashboard
   pg-dash check <connection-string>                     Run health check and exit
+  pg-dash health <connection-string>                    Alias for check
   pg-dash check-migration <file> [connection]           Analyze migration SQL for risks
   pg-dash diff-env --source <url> --target <url>        Compare two environments
   pg-dash schema-diff <connection-string>               Show latest schema changes
@@ -4120,7 +4121,12 @@ Environment variables:
 `);
   process.exit(0);
 }
+var KNOWN_SUBCOMMANDS = ["check", "health", "check-migration", "schema-diff", "diff-env"];
 var subcommand = positionals[0];
+function isValidConnectionString(s) {
+  return s.startsWith("postgresql://") || s.startsWith("postgres://") || s.includes("@") || // user@host shorthand
+  s.includes("=");
+}
 function resolveConnectionString(startIdx = 0) {
   let connStr = positionals[startIdx];
   if (!connStr) {
@@ -4136,9 +4142,19 @@ function resolveConnectionString(startIdx = 0) {
       process.exit(1);
     }
   }
+  if (!isValidConnectionString(connStr)) {
+    console.error(
+      `Error: "${connStr}" doesn't look like a valid connection string.
+  Expected: postgresql://user:pass@host:5432/db
+
+Known subcommands: ${KNOWN_SUBCOMMANDS.join(", ")}
+Run pg-dash --help for usage.`
+    );
+    process.exit(1);
+  }
   return connStr;
 }
-if (subcommand === "check") {
+if (subcommand === "check" || subcommand === "health") {
   const connectionString = resolveConnectionString(1);
   const threshold = parseInt(values.threshold || "70", 10);
   const format = values.format || "text";
@@ -4463,6 +4479,15 @@ Migration check: ${filePath}`);
     process.exit(1);
   }
 } else {
+  if (subcommand && !isValidConnectionString(subcommand) && KNOWN_SUBCOMMANDS.indexOf(subcommand) === -1) {
+    console.error(
+      `Error: Unknown subcommand "${subcommand}".
+
+Known subcommands: ${KNOWN_SUBCOMMANDS.join(", ")}
+Run pg-dash --help for usage.`
+    );
+    process.exit(1);
+  }
   const connectionString = resolveConnectionString(0);
   const port = parseInt(values.port, 10);
   const bind = values.bind || process.env.PG_DASH_BIND || "127.0.0.1";