Add config, filters, HTML reports, diffs, and watch mode

Author: deniscuciuc

.gitignore

@@ -9,6 +9,7 @@ dist/
 .local.env
 .env
 .env.local
+.analyzerrc.json
 
 # Reports
 reports/*.md

CHANGELOG.md

@@ -24,3 +24,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Dependabot configuration for npm + GitHub Actions
 - MIT license
 - Makefile with common development targets
+- Config-file support via `.analyzerrc.json`, global fallback config, and named connection profiles
+- Schema and table filters for scoped PostgreSQL analysis runs
+- Self-contained HTML report generation with light/dark mode and sortable sections
+- Report diffing against previous JSON snapshots with delta summaries
+- Watch mode for polling-safe commands with refresh intervals and countdown feedback
+- `pnpm analyze:html` and `pnpm analyze:watch` convenience scripts
+
+### Changed
+
+- Full analysis output can now generate Markdown, JSON, and optional HTML reports from the same run
+- Compare mode accepts saved JSON reports and wrapped CLI JSON output when diffing snapshots
+
+### Fixed
+
+- Explicit `--profile` selection now overrides sourced environment connection defaults for the active run

README.md

@@ -96,6 +96,28 @@ export DB_SSL=true
 # export PGPASSWORD=...
 ```
 
+### Config file (`.analyzerrc.json`)
+
+Place `.analyzerrc.json` in your project root (or `~/.config/db-analyzer/config.json` for global settings).
+Copy `analyzerrc.example.json` to get started:
+
+```bash
+cp analyzerrc.example.json .analyzerrc.json
+```
+
+Connection profiles let you switch databases without re-typing flags:
+
+```bash
+# use a named profile
+. ./.env && npx ts-node index.ts -c health --profile prod
+
+# or with npm script
+pnpm analyze:health -- --profile staging
+```
+
+CLI flags always win. When you explicitly select a profile with `--profile`, that
+profile's connection fields override sourced environment defaults for that run.
+
 ---
 
 ## Usage
@@ -119,6 +141,8 @@ pnpm analyze:tables       # Largest tables
 pnpm analyze:fk           # Foreign keys without indexes
 pnpm analyze:connections  # Connection statistics
 pnpm analyze:config       # PostgreSQL configuration
+pnpm analyze:html         # Full analysis + Markdown + HTML reports
+pnpm analyze:watch        # Live health dashboard (refreshes every 30s)
 
 # Server info
 pnpm server:info
@@ -190,6 +214,13 @@ npx ts-node index.ts -h localhost -p 5432 -d mydb -U postgres -W secret --ssl -j
 | `--user`                   | `-U`  | Database user                            | `postgres`  |
 | `--password`               | `-W`  | Database password                        | -           |
 | `--ssl`                    |       | Enable SSL                               | `false`     |
+| `--profile`                |       | Use a named connection profile from `.analyzerrc.json` | - |
+| `--config`                 |       | Path to a config file                    | auto-search |
+| `--schemas`                |       | Comma-separated schema names to analyze  | all         |
+| `--tables`                 |       | Comma-separated table names to analyze   | all         |
+| `--compare`                |       | Path to a previous JSON report for diffing | -         |
+| `--html`                   |       | Also generate an HTML report             | `false`     |
+| `--watch`                  |       | Poll interval in seconds (enables watch mode) | -      |
 | `--command`                | `-c`  | Run a single command (see table)         | `full`      |
 | `--json`                   | `-j`  | JSON output                              | `false`     |
 | `--quiet`                  | `-q`  | Suppress progress output                 | `false`     |
@@ -241,6 +272,40 @@ Saved to `./reports/db-analysis-{timestamp}.md`.
 }
 ```
 
+### HTML report
+
+Generated by `pnpm analyze:html` or `pnpm analyze -- --html`. Includes the same content
+as the Markdown report in a self-contained HTML file with:
+
+- Light/dark mode (follows OS preference)
+- Color-coded severity badges
+- Collapsible sections
+- Sortable tables
+- No external dependencies — share as a single file
+
+Saved to `./reports/db-analysis-{timestamp}.html`.
+
+### Report diff
+
+Compare two snapshots to see what changed:
+
+```bash
+# save a baseline
+pnpm analyze
+
+# later, compare
+pnpm analyze -- --compare ./reports/db-analysis-2026-01-01.json
+```
+
+Output:
+```
+⬆️  Health score       72 → 85 (+13)  ✓ better
+⬇️  Cache hit ratio    99.1% → 98.2% (-0.9%)  ✗ worse
+↔️  Slow queries       8 → 8  no change
+⚠️  New issues (1): idx_products_old (unused index)
+✓  Resolved (2): idx_users_tmp, idx_orders_status_old
+```
+
 ---
 
 ## Health score

analyzerrc.example.json

@@ -0,0 +1,25 @@
+{
+  "profiles": {
+    "local": {
+      "host": "localhost",
+      "port": 5432,
+      "database": "mydb",
+      "user": "postgres"
+    },
+    "prod": {
+      "host": "prod.db.internal",
+      "database": "mydb",
+      "user": "readonly",
+      "ssl": true
+    }
+  },
+  "defaultProfile": "local",
+  "thresholds": {
+    "cacheHitRatio": { "warning": 95, "critical": 90 },
+    "indexHitRatio": { "warning": 95, "critical": 90 },
+    "deadTuplesRatio": { "warning": 5, "critical": 10 }
+  },
+  "slowQueryThreshold": 100,
+  "minIndexScans": 50,
+  "output": "./reports"
+}