@indiekitai/pg-dash 0.5.0 → 0.5.1

package/README.md

@@ -21,6 +21,12 @@ npx @indiekitai/pg-dash check postgres://user:pass@host/db
 # Check migration safety before running it
 npx @indiekitai/pg-dash check-migration ./migrations/015_add_index.sql
 
+# EXPLAIN ANALYZE a slow query in the terminal
+npx @indiekitai/pg-dash explain "SELECT * FROM orders WHERE user_id = 1" postgres://...
+
+# Real-time lock + long-query monitor (Ctrl+C to exit)
+npx @indiekitai/pg-dash watch-locks postgres://...
+
 # Compare two environments (local vs staging)
 npx @indiekitai/pg-dash diff-env --source postgres://localhost/db --target postgres://staging/db
 
@@ -102,6 +108,45 @@ The Dashboard is there when you need it. But the real power is in the CLI, MCP,
 - Auto-detects Slack vs Discord webhook URLs
 - Configure via `--slack-webhook` or `--discord-webhook`
 
+### 🔬 EXPLAIN ANALYZE CLI
+
+```bash
+pg-dash explain "SELECT * FROM orders WHERE user_id = 1" postgres://...
+```
+
+```
+Query: SELECT * FROM orders WHERE user_id = 1
+
+Limit cost=3.01..3.04 actual=0.060ms rows=10/10
+└─ Sort cost=3.01..3.09 actual=0.057ms rows=10/32
+  └─ Seq Scan on users cost=0.00..2.32 actual=0.023ms rows=32/32
+
+─── Summary ────────────────────────────────────
+  Execution time:  0.087ms
+  Planning time:   0.756ms
+  Seq Scans:       users
+
+─── Recommendations ────────────────────────────
+  ℹ  Sort on [created_at DESC]. An index might eliminate this.
+```
+
+- Color-coded node types: 🔴 Seq Scan, 🟢 Index Scan, 🟡 Hash Join, 🟣 Sort
+- Shows actual vs estimated rows — catches bad planner estimates
+- Flags Seq Scans > 1000 rows, Sort nodes, Hash Join memory spills
+- `--no-analyze` for dry EXPLAIN (no actual execution)
+- `--json` for scripting
+
+### 🔒 watch-locks
+
+```bash
+pg-dash watch-locks postgres://...
+```
+
+Real-time lock wait monitor — refreshes every 3 seconds. Shows:
+- Blocked queries with PID, wait time, and the blocking query
+- Long-running queries (configurable threshold via `--long-query-threshold`)
+- Table and lock type for each wait
+
 ### 🛡️ Migration Safety Check
 - Analyze a migration SQL file for risks before running it
 - Detects: `CREATE INDEX` without `CONCURRENTLY` (lock risk), `ADD COLUMN NOT NULL` without `DEFAULT`, `ALTER COLUMN TYPE` (full table rewrite), `DROP COLUMN` (app breakage risk), `ADD CONSTRAINT` without `NOT VALID` (full table scan), `CREATE INDEX CONCURRENTLY` inside a transaction (runtime failure), `DROP TABLE`, `TRUNCATE`, `DELETE`/`UPDATE` without `WHERE`

package/README.zh-CN.md

@@ -21,6 +21,12 @@ npx @indiekitai/pg-dash check postgres://user:pass@host/db
 # 执行 migration 前检查风险
 npx @indiekitai/pg-dash check-migration ./migrations/015_add_index.sql
 
+# 终端里分析慢查询（彩色树形输出 + 建议）
+npx @indiekitai/pg-dash explain "SELECT * FROM orders WHERE user_id = 1" postgres://...
+
+# 实时锁监控（Ctrl+C 退出）
+npx @indiekitai/pg-dash watch-locks postgres://...
+
 # 对比两个环境（本地 vs 预发）
 npx @indiekitai/pg-dash diff-env --source postgres://localhost/db --target postgres://staging/db
 
@@ -173,6 +179,8 @@ pg-dash --host localhost --user postgres --db mydb --port 3480
 pg-dash <connection-string>                      启动面板
 pg-dash check <connection-string>                运行健康检查并退出
 pg-dash check-migration <file> [conn]            检查 migration SQL 的风险
+pg-dash explain "<query>" <connection>           终端里 EXPLAIN ANALYZE 查询
+pg-dash watch-locks <connection>                 实时锁和长查询监控
 pg-dash diff-env --source <url> --target <url>   对比两个环境
 pg-dash schema-diff <connection-string>          显示 Schema 变更
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indiekitai/pg-dash",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Lightweight PostgreSQL monitoring dashboard",
   "type": "module",
   "bin": {