@indiekitai/pg-dash 0.5.2 → 0.7.0

package/README.md

@@ -2,7 +2,7 @@
 
 # pg-dash
 
-**The AI-native PostgreSQL health checker.** One command to audit your database, 23 MCP tools for AI-assisted optimization, CI integration for automated checks.
+**The AI-native PostgreSQL health checker.** One command to audit your database, 25 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)**
 
@@ -55,7 +55,7 @@ The Dashboard is there when you need it. But the real power is in the CLI, MCP,
 | pganalyze | $149+/mo | SaaS signup | ❌ | ❌ |
 | Grafana+Prometheus | Free | 3 services | ❌ | ❌ |
 | pgAdmin | Free | Complex UI | ❌ | ❌ |
-| **pg-dash** | **Free** | **One command** | **23 MCP tools** | **`--ci --diff`** |
+| **pg-dash** | **Free** | **One command** | **25 MCP tools** | **`--ci --diff`** |
 
 ## Features
 
@@ -147,6 +147,23 @@ Real-time lock wait monitor — refreshes every 3 seconds. Shows:
 - Long-running queries (configurable threshold via `--long-query-threshold`)
 - Table and lock type for each wait
 
+### 📊 query-stats (PG 18+)
+
+```bash
+# Export query statistics from production
+pg-dash query-stats export postgres://prod-server/db --file prod-stats.json
+
+# Import to development environment
+pg-dash query-stats import prod-stats.json postgres://localhost/db
+```
+
+Export/import PostgreSQL query statistics (requires PG 18+). Enables "production query plans without production data" workflow:
+1. Export stats from production: `pg-dash query-stats export prod`
+2. Import to dev: `pg-dash query-stats import prod-stats.json dev`
+3. Run `EXPLAIN` locally — now uses production statistics for accurate query plans
+
+The exported JSON is typically <1MB regardless of database size.
+
 ### 🛡️ 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`
@@ -246,6 +263,8 @@ Options:
   --discord-webhook <url>  Discord webhook URL for alert notifications
   --ci                   Output GitHub Actions annotations (check, check-migration, diff-env)
   --diff                 Compare with last snapshot (check command)
+  --ai-suggest           Use AI to generate fix suggestions (requires LLM config)
+  --ai-explain           Use AI to explain schema diff business impact (requires LLM config)
   --snapshot-path <path> Path to snapshot file for --diff
   --health               Include health comparison (diff-env)
   -v, --version          Show version
@@ -263,7 +282,7 @@ pg-dash-mcp postgres://user:pass@host/db
 PG_DASH_CONNECTION_STRING=postgres://... pg-dash-mcp
 ```
 
-### Available Tools (23)
+### Available Tools (25)
 
 | Tool | Description |
 |------|-------------|
@@ -290,6 +309,9 @@ PG_DASH_CONNECTION_STRING=postgres://... pg-dash-mcp
 | `pg_dash_autovacuum` | Check autovacuum health — which tables are stale or never vacuumed |
 | `pg_dash_locks` | Show active lock waits and long-running blocking queries |
 | `pg_dash_config_check` | Audit PostgreSQL configuration and get tuning recommendations |
+| `fetch_db_context` | Comprehensive DB context for AI agents: all table structures, columns, types, PKs/FKs, indexes, business intent inference, and health summary (single call for full context) |
+| `pg_dash_query_natural` | Query database using natural language — LLM converts your question to SQL and returns results. Example: "show me slow queries last hour", "find missing indexes", "what's the health score", "list all tables with their sizes" |
+| `ci_health_summary` | Generate a CI-friendly health summary with AI-powered prioritization. Input: health check result (from pg_dash_health). Output: one-sentence summary + prioritized issue list. Perfect for GitHub Actions/GitLab CI integration. |
 
 ## MCP Setup
 

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 # pg-dash
 
-**AI 原生的 PostgreSQL 健康检查工具。** 一条命令审计数据库，23 个 MCP 工具让 AI 帮你优化，CI 集成自动检查。
+**AI 原生的 PostgreSQL 健康检查工具。** 一条命令审计数据库，25 个 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)**
 
@@ -55,7 +55,7 @@ Dashboard 需要时可以用。但真正的核心能力在 CLI、MCP 和 CI。
 | pganalyze | $149+/月 | SaaS 注册 | ❌ | ❌ |
 | Grafana+Prometheus | 免费 | 配置 3 个服务 | ❌ | ❌ |
 | pgAdmin | 免费 | 界面复杂 | ❌ | ❌ |
-| **pg-dash** | **免费** | **一条命令** | **23 个 MCP 工具** | **`--ci --diff`** |
+| **pg-dash** | **免费** | **一条命令** | **25 个 MCP 工具** | **`--ci --diff`** |
 
 ## 功能
 
@@ -183,6 +183,8 @@ 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 变更
+pg-dash query-stats export <connection>          导出查询统计（PG 18+）
+pg-dash query-stats import <file> <connection>   导入查询统计（PG 18+）
 
 Options:
   -p, --port <port>      面板端口（默认：3480）
@@ -202,6 +204,8 @@ Options:
   --discord-webhook <url>  Discord webhook URL，用于告警通知
   --ci                   输出 GitHub Actions 注解（check、check-migration、diff-env）
   --diff                 与上次快照对比（check 命令）
+  --ai-suggest           使用 AI 生成修复建议（需要配置 LLM）
+  --ai-explain           使用 AI 解释 Schema 差异的业务影响（需要配置 LLM）
   --snapshot-path <path> --diff 使用的快照文件路径
   --health               包含健康对比（diff-env）
   -v, --version          显示版本
@@ -219,7 +223,7 @@ pg-dash-mcp postgres://user:pass@host/db
 PG_DASH_CONNECTION_STRING=postgres://... pg-dash-mcp
 ```
 
-### 可用工具（23 个）
+### 可用工具（25 个）
 
 | 工具 | 描述 |
 |------|------|
@@ -246,6 +250,9 @@ PG_DASH_CONNECTION_STRING=postgres://... pg-dash-mcp
 | `pg_dash_autovacuum` | Autovacuum 健康状态——哪些表长期未 vacuum |
 | `pg_dash_locks` | 显示活跃锁等待链和长时间阻塞的查询 |
 | `pg_dash_config_check` | 审计 PostgreSQL 配置，给出调优建议 |
+| `fetch_db_context` | AI Agent 用的完整数据库上下文：所有表结构、列类型、主键外键、索引、业务意图推断、健康摘要（一次调用获取全部信息） |
+| `pg_dash_query_natural` | 自然语言查询数据库——LLM 将你的问题转换为 SQL 并返回结果。示例："显示最近一小时的慢查询"、"查找缺失的索引"、"健康评分是多少"、"列出所有表及其大小" |
+| `ci_health_summary` | 生成 CI 友好的健康摘要（AI 辅助优先级排序）。输入：健康检查结果。输出：一句自然语言总结 + 优先级排序的问题列表。非常适合集成到 GitHub Actions/GitLab CI。 |
 
 ## MCP 配置