Add snapshot.sh — LLM-friendly plain text dump of all reports

[NikolayS]

What

snapshot.sh runs all safe reports non-interactively and outputs clean plain text. Designed for feeding database state to LLMs, saving to files, or piping into automation.

Usage

./snapshot.sh -h localhost -U postgres -d mydb           # plain text output
./snapshot.sh -d mydb > snapshot.txt                     # save to file
./snapshot.sh -d mydb | pbcopy                           # clipboard (macOS)
./snapshot.sh --full -d mydb                             # include expensive reports

What it does

• Runs 25 reports (out of 34) with clean text output
• Strips: ANSI colors, psql file references, DO/SET noise, NOTICE: prefixes
• Converts WARNING: to ⚠️ for visibility
• Caps each report at 500 lines

Skipped by default (safe/fast only)

Skipped	Reason
b3, b4	Expensive (pgstattuple full table scans)
c2, c3, c4	Heavy or blocking amcheck
m1	Expensive (pg_buffercache scan)
p1	Progress — only useful during active operations
r1, r2	Interactive (require user input)

--full includes everything except r1/r2.

Output

~1500 lines / ~430KB for a typical database. Fits comfortably in LLM context windows.

Tested on

PG17 (localhost). Output is clean and parseable.

[tembo]

Minor quoting nit: since this runs in a trap, it’s safer to quote the tmp path to avoid word-splitting/globbing edge cases.

Suggested change

	trap "rm -f $PSQLRC_TMP" EXIT
	trap 'rm -f "$PSQLRC_TMP"' EXIT

[tembo]

If someone runs this in a checkout without sql/*.sql (or the glob doesn’t match), bash will iterate the literal pattern and the script will fail under set -e. Enabling nullglob avoids that surprise.

Suggested change

	set -euo pipefail
	set -euo pipefail
	shopt -s nullglob