Finalize release notes for 7.0

Author: NikolayS

RELEASE_NOTES.md

@@ -4,76 +4,67 @@
 
 ## New Reports
 
-### Corruption checks (c1, c2, c3) — powered by `amcheck`
+### Corruption checks (c1–c4) — powered by `amcheck`
 
-Three levels of integrity checking, all requiring `CREATE EXTENSION amcheck`:
+Four levels of integrity checking, from quick production-safe to full paranoia:
 
 | Report | Lock | What it checks | When to use |
 |--------|------|----------------|-------------|
 | **c1** | AccessShareLock | B-tree pages, GIN indexes (PG18+) | **Production** — fast, safe, non-blocking |
 | **c2** | AccessShareLock | c1 + heap/TOAST integrity (PG14+) | **Production** — safe but reads all data |
-| **c3** | ShareLock ⚠️ | B-tree parent-child ordering, sibling pointers, rootdescend, checkunique (PG14+) | **Clones or standbys** — detects glibc/collation corruption |
-| **c4** | ShareLock ⚠️⚠️ | Everything in c3 + heapallindexed + verify_heapam with full TOAST | **Clones only** — proves every heap tuple is indexed, slow on large DBs |
+| **c3** | ShareLock | B-tree parent-child ordering, sibling pointers, rootdescend, checkunique (PG14+) | **Clones** — detects glibc/collation corruption |
+| **c4** | ShareLock | Everything in c3 + heapallindexed + verify_heapam with full TOAST | **Clones only** — proves every heap tuple is indexed, slow |
 
-All three check system catalog indexes (`pg_catalog`, `pg_toast`) — because catalog corruption is the scariest kind.
+All four check system catalog indexes (`pg_catalog`, `pg_toast`).
 
-Robustness:
-- Graceful handling when `amcheck` extension is not installed
-- No false corruption reports on insufficient privileges (reports skipped count)
-- Version-conditional: uses appropriate function signatures for PG11–18
-- GIN support via `gin_index_check()` on PostgreSQL 18+
+Requires `CREATE EXTENSION amcheck`. Graceful handling when extension is missing or user lacks privileges. Version-conditional function signatures for PG11–18. GIN support via `gin_index_check()` on PG18+.
 
 ### m1 — Buffer cache contents
-What's in your `shared_buffers` right now. Shows cached size vs total size, % of cache used per object, and dirty buffer counts. Requires `pg_buffercache` extension.
+What's in `shared_buffers`: cached size vs total, % of cache per object, dirty buffer counts. Includes system catalogs. Requires `pg_buffercache`.
 
 ### s3 — Workload profile by query type
-Groups `pg_stat_statements` by first SQL keyword (SELECT, INSERT, UPDATE, DELETE, etc.) to show workload composition at a glance. Correctly handles queries with leading block comments (`/* ... */`) and line comments (`-- ...`).
+Groups `pg_stat_statements` by first SQL keyword (SELECT, INSERT, UPDATE, DELETE, etc.). Handles leading block comments (`/* ... */`) and line comments (`-- ...`).
 
 ### t2 — Objects with custom storage parameters
-Lists all tables, indexes, and materialized views with non-default `reloptions`. Flags potentially problematic settings: disabled autovacuum on large tables, low fillfactor, aggressive vacuum scale factors. Shows partition relationships.
+Tables, indexes, and materialized views with non-default `reloptions`. Flags: disabled autovacuum on large tables, low fillfactor, aggressive vacuum scale factors.
 
 ### Report 0 — WAL and replication slot info
-The node information report now includes:
-- **WAL**: current LSN, file count, total WAL size
-- **Replication Slots**: name, type, active/inactive status, lag from current WAL position
+Node information now includes WAL position, file count, total WAL size, and replication slot status.
 
 ## Report Renames
 
-Categories reorganized for consistency:
-
 | Old | New | Reason |
 |-----|-----|--------|
 | b6 | **m1** | Buffer cache → **m** (memory) category |
 | c1 | **p1** | Index creation progress → **p** (progress) category |
-| p1 | **x1** | Alignment padding (experimental) → **x** (experimental) category |
+| p1 | **x1** | Alignment padding → **x** (experimental) category |
+
+v1/v2 descriptions clarified: v1 is "running operations (detailed progress)", v2 is "autovacuum queue and pending tables".
 
 ## Bug Fixes
 
-- **i3**: Fixed `operator is not unique` error when `intarray` extension is installed (added explicit `::int2[]` cast)
+- **s1, s2**: Fixed `blk_read_time does not exist` on PG17+ (renamed to `shared_blk_read_time` in pg_stat_statements 1.11)
 - **s3**: Fixed `function round(double precision, integer) does not exist` — added `::numeric` casts
-- **i2**: Removed unused `redundant_indexes_grouped` CTE (dead code)
-- **s1**: Removed duplicate `sum(calls)` in the pre-PG13 code path
+- **i3**: Fixed `operator is not unique` error when `intarray` extension is installed
+- **m1**: Include system catalogs in buffer cache report (was showing empty on small databases)
+- **i2**: Removed dead code (`redundant_indexes_grouped` CTE)
+- **s1**: Removed duplicate `sum(calls)` in pre-PG13 code path
 
 ## Terminology
 
-- Updated `Master` → `Primary` across all reports and CI (0_node, i2, i4, i5)
-
-## Typo Fixes
-
-- `inspect` → `inspects` (b1, b2)
-- `filed` → `fields`, `fractionnal` → `fractional`, `functionnal` → `functional` (b2)
-- `alt_shits` → `alt_shifts` (p1) 🙈
-- `Vaccuum` → `Vacuum` (b1)
-- `format` → `formatting` (s2)
-- Comment formatting: added space after `--` throughout (b3, b4, l1, s2, v2)
+`Master` → `Primary` across all reports and CI.
 
-## CI Improvements
+## Other Improvements
 
-- Added `PAGER=cat` to all `psql` invocations (prevents pager hangs)
-- Added `intarray`, `pg_buffercache`, and `amcheck` extensions to test matrix
-- Added foreign key test tables for i3 regression testing
-- Added dedicated i3 regression test with `intarray` installed
+- Modernized README with badges, individual credits, optional extensions table
+- Fixed Quick Start psqlrc escaping
+- Fixed menu spacing for new reports
+- `alt_shits` → `alt_shifts` (p1)
+- Various typo fixes across b1, b2, b3, b4, l1, s2, v2
 
-## Compatibility
+## CI
 
-Tested on PostgreSQL 13, 14, 15, 16, 17, and 18 — all 34 reports pass with both superuser and `pg_monitor` roles.
+- All 34 reports tested on PG 13, 14, 15, 16, 17, 18
+- Added `amcheck`, `intarray`, `pg_buffercache` extensions to test matrix
+- Added i3 regression test with `intarray` installed
+- Added `PAGER=cat` to prevent pager hangs