update pig rpm deb infra pkg release

Author: Vonng

content/docs/pg_exporter/release.md

@@ -3,10 +3,11 @@ title: Release Notes
 weight: 5660
 ---
 
-The latest stable version of `pg_exporter` is [v1.1.2](https://github.com/pgsty/pg_exporter/releases/tag/v1.1.2)
+The latest stable version of `pg_exporter` is [v1.2.0](https://github.com/pgsty/pg_exporter/releases/tag/v1.2.0)
 
 |     Version     |    Date    | Summary                                                 |                               GitHub                               |
 |:---------------:|:----------:|---------------------------------------------------------|:------------------------------------------------------------------:|
+| [v1.2.0](#v120) | 2026-02-12 | various bug fix, PG9.x legacy support                   | [v1.2.0](https://github.com/pgsty/pg_exporter/releases/tag/v1.2.0) |
 | [v1.1.2](#v112) | 2026-01-16 | fix pg_timeline conf issue, build with latest deps      | [v1.1.2](https://github.com/pgsty/pg_exporter/releases/tag/v1.1.2) |
 | [v1.1.1](#v111) | 2025-12-30 | New pg_timeline collector, pg_sub_16 branch, bug fixes  | [v1.1.1](https://github.com/pgsty/pg_exporter/releases/tag/v1.1.1) |
 | [v1.1.0](#v110) | 2025-12-15 | Update default metrics collectors, bump to go 1.25.5    | [v1.1.0](https://github.com/pgsty/pg_exporter/releases/tag/v1.1.0) |
@@ -36,6 +37,47 @@ The latest stable version of `pg_exporter` is [v1.1.2](https://github.com/pgsty/
 | [v0.0.1](#v001) | 2019-12-06 | Initial release with PgBouncer mode                     | [v0.0.1](https://github.com/pgsty/pg_exporter/releases/tag/v0.0.1) |
 
 
+## v1.2.0
+
+`v1.2.0` is a stability-and-compatibility focused minor release across startup flow, hot reload, health probing, config validation, and legacy support.
+
+**New Features:**
+
+- Add robust hot reload workflow: support platform-specific reload signals (`SIGHUP` / `SIGUSR1`) and strengthen `POST /reload` to refresh configs and query plans without process restart
+- Switch startup to non-blocking mode: HTTP endpoints come up first even when target precheck fails, making recovery and monitoring integration smoother
+- Add PostgreSQL 9.1-9.6 legacy config bundle: provide `legacy/` configs and a `make conf9` target for easier onboarding of EOL PostgreSQL versions
+- Rework health probing architecture: use cached health snapshots with periodic probes for more consistent role-based health endpoints and smoother reload behavior
+- Improve release engineering baseline: run `go test` and `go vet` in release workflows and bump build toolchain to Go 1.26.0
+
+**Bug Fixes:**
+
+- Fix multiple config parsing edge cases: reject malformed metrics entries, return explicit errors when config dirs fail to load valid YAML, and harden runtime fallbacks
+- Fix CLI bool flag parsing to correctly handle `--flag=false` style arguments
+- Fix `/explain` output/rendering behavior by adjusting content type handling and using safer template rendering
+- Fix predicate query and PG URL handling details: better BOOL/BOOLEAN predicate support, safer row lifecycle handling, and improved `dbname` query-parameter parsing/redaction
+- Fix resource cleanup when auto-discovered targets are removed by closing dropped server connections asynchronously
+- Fix metric/label validation details including const-label conflict checks, scaled default-value handling, and Prometheus naming/rule checks
+
+**Checksums**
+
+```bash
+26e7a052e730b412bbbe5f49846f951b89650f1f95c2466d5d486923f0825f64  pg-exporter_1.2.0-1_amd64.deb
+4ec219135c49708d010af7b8a7553b8008f630574e1d4cfc7642fbf951eefafe  pg-exporter_1.2.0-1_arm64.deb
+5b2cc00e2c3e2ffd9eb0ab1a4f5e937dd68f3a69a14423a74d4de3d7cf29283e  pg-exporter_1.2.0-1_ppc64le.deb
+d536d41a92e8aa85ae3935715d1bf0463208b1e614eae73543f1472ca8a7e0d4  pg_exporter-1.2.0-1.aarch64.rpm
+b7a1daa225f8ca4de6d227e6004330589295d924accd221892ebe14f191fe35c  pg_exporter-1.2.0-1.ppc64le.rpm
+28bf7d85862510675c64ff5181d216c6a068a23ffa56dc4bb9e6b82165ff99b5  pg_exporter-1.2.0-1.x86_64.rpm
+51c3b3d18089d888a54a6b3e7ecb0620dc0da04c81471a0b7aaa88c1677ddb8c  pg_exporter-1.2.0.darwin-amd64.tar.gz
+3ba1c7adea9c926afd3054ba18cc43e665e420a495bfcfd2248242c49a67b077  pg_exporter-1.2.0.darwin-arm64.tar.gz
+9e1ec6c15e6b2aaadbe27a27053ee1ec289bdd012c19ca6371de738fa5f8843e  pg_exporter-1.2.0.linux-amd64.tar.gz
+9e18849693ccda313979db0a230cb81acfe4199364feb6ce3e72d1a89fbfb809  pg_exporter-1.2.0.linux-arm64.tar.gz
+6e28489685d0bd1fdabcb71474f64f559ade199b871666954323bae9dc01465f  pg_exporter-1.2.0.linux-ppc64le.tar.gz
+9e9beac619fe2c614a77bc3334bc4b80df9db355bf95845eb4b11674ddad52d9  pg_exporter-1.2.0.windows-amd64.tar.gz
+```
+
+https://github.com/pgsty/pg_exporter/releases/tag/v1.2.0
+
+
 ## v1.1.2
 
 Minor release fixing pg_timeline configuration issue and building with latest go deps

content/docs/pig/_index.md

@@ -12,12 +12,7 @@ PIG is a command-line tool specifically designed for installing, managing, and b
 PIG is not a reinvented wheel, but rather a **PiggyBack** - a high-level abstraction layer that leverages existing Linux distribution package managers (`apt`/`dnf`).
 It abstracts away the differences between operating systems, chip architectures, and PG major versions, allowing you to install and manage PG kernels and 444+ extensions with just a few simple commands.
 
-PIG is also an **Agentic Native CLI**: it supports global `-o|--output` structured output (`yaml` / `json` / `json-pretty`), and provides a **Capability Map** and **Command Schema** for AI/automation. For example:
-
-```bash
-pig --help -o yaml        # capability map
-pig ext --help -o json    # command schema (params/flags/risk/parallelism/confirmation levels)
-```
+PIG is also automation-friendly by design: consistent parameter styles, clear error messages, and safe guards like `--dry-run` for high-risk operations.
 
 Please note: for extension installation, **pig is not a mandatory component**. You can still use apt/dnf package managers to directly access the [**Pigsty PGSQL**](/docs/repo/pgsql/) repository.
 

content/docs/pig/build.md

@@ -21,7 +21,7 @@ Commands:
   pgrx      Install pgrx
   pkg       Complete build pipeline: get, dep, ext
   proxy     Init build proxy
-  repo      Init build repo
+  repo      Init build repo (=repo set, with remove+update)
   rust      Install rust
   spec      Init building spec repo
   tool      Init build tools
@@ -68,7 +68,7 @@ pig build repo                   # Setup repositories
 pig build tool                   # Install build tools
 
 # Install Rust (for Rust extensions)
-pig build rust -y                # Install Rust
+pig build rust -y                # Force reinstall Rust (default does not reinstall)
 pig build pgrx                   # Install PGRX framework
 
 # Build extensions
@@ -91,7 +91,7 @@ pig build spec -f                # Force overwrite existing files
 Setup repositories required for building.
 
 ```bash
-pig build repo                   # Setup repositories
+pig build repo                   # Equivalent to: pig repo set (internally remove+update)
 ```
 
 
@@ -111,7 +111,7 @@ Install Rust toolchain (for building Rust extensions).
 
 ```bash
 pig build rust                   # Install Rust
-pig build rust -y                # Auto-confirm
+pig build rust -y                # Force reinstall Rust toolchain
 ```
 
 
@@ -234,7 +234,7 @@ sudo dpkg -i ~/pg_partman*.deb                         # Debian
 # 1. Setup Rust environment
 pig build spec
 pig build tool
-pig build rust -y
+pig build rust                   # add -y only if you need to force reinstall
 pig build pgrx
 
 # 2. Build Rust extension
@@ -306,4 +306,3 @@ cargo install cargo-pgrx --force
 # Reinitialize PGRX
 cargo pgrx init
 ```
-

content/docs/pig/cmd.md

@@ -61,26 +61,13 @@ Flags:
   -h, --help               help for pig
   -H, --home string        Pigsty home path
   -i, --inventory string   config inventory path
-  -o, --output string      output format: text, yaml, json, json-pretty
+  -t, --toggle             placeholder flag shown in help output
       --log-level string   log level: debug, info, warn, error, fatal, panic (default "info")
       --log-path string    log file path, terminal by default
 
 Use "pig [command] --help" for more information about a command.
 ```
 
-## Agentic Native CLI
-
-`pig` supports structured output and capability discovery for AI/automation:
-
-```bash
-pig --help -o yaml         # capability map
-pig ext --help -o json     # command schema (params/flags/metadata)
-pig ext list -o json       # structured result: success / code / message / data
-```
-
-Note: `-o json-pretty` outputs indented JSON. Structured output currently mainly covers `ext` / `repo` / `pitr` and `help`; other commands remain text output.
-
-
 ## pig repo
 
 Manage APT/YUM repositories for PostgreSQL packages. See [`pig repo`](/docs/pig/repo/) for details.
@@ -129,7 +116,7 @@ Build PostgreSQL extensions from source. See [`pig build`](/docs/pig/build/) for
 pig build spec                   # initialize build specs
 pig build repo                   # setup repositories
 pig build tool                   # install build tools
-pig build rust -y                # install Rust (for Rust extensions)
+pig build rust -y                # force reinstall Rust (default does not reinstall)
 pig build pgrx                   # install PGRX framework
 
 # build extensions
@@ -190,7 +177,7 @@ pig pb info                      # show backup info
 pig pb ls                        # list all backups
 pig pb backup                    # create backup
 pig pb backup full               # full backup
-pig pb restore                   # restore to latest
+pig pb restore -d                # restore to latest
 pig pb restore -t "2025-01-01"   # restore to specific time
 pig pb log tail                  # real-time log viewing
 ```
@@ -204,8 +191,7 @@ Orchestrated Point-In-Time Recovery. See [`pig pitr`](/docs/pig/pitr/) for detai
 pig pitr -d                      # recover to latest (most common)
 pig pitr -t "2025-01-01 12:00"   # recover to specific time
 pig pitr -I                      # recover to backup consistency point
-pig pitr -d --plan               # show execution plan
-pig pitr -d --dry-run            # alias for --plan
+pig pitr -d --dry-run            # show execution plan without running
 pig pitr -d -y                   # skip confirmation (for automation)
 pig pitr -d --skip-patroni       # skip Patroni management
 pig pitr -d --no-restart         # don't auto-start PostgreSQL after restore

content/docs/pig/ext.md

@@ -81,7 +81,6 @@ List or search extensions.
 ```bash
 pig ext list                     # List all extensions
 pig ext list duck                # Search for "duck" extensions
-pig ext list vector ai           # Search multiple keywords
 pig ext list -v 17               # Filter by PG version
 pig ext ls olap                  # List OLAP category extensions
 pig ext ls gis -v 16             # List GIS extensions for PG 16
@@ -149,17 +148,15 @@ pig install pg_duckdb -v 17 -y
 **Options:**
 - `-v|--version`: Specify PG major version
 - `-y|--yes`: Auto-confirm installation
-- `-n|--no-translation`: Disable alias translation
 
 
 ## ext rm
 
-Remove extensions. Also available via alias `pig remove`.
+Remove extensions.
 
 ```bash
 pig ext rm pg_duckdb             # Remove pg_duckdb
 pig ext rm pg_duckdb -v 17       # Remove for PG 17
-pig remove pg_duckdb             # Using alias
 ```
 
 
@@ -223,7 +220,7 @@ To install PostgreSQL extensions, you'll have to add the [**repo**](/docs/pig/re
 
 ```bash
 pig repo add pgdg pigsty -u    # gentle way to add pgdg and pigsty repo
-pig repo set -u                # brute way to remove and add all required repos
+pig repo set                   # brute way to remove and add all required repos
 ```
 
 Then you can search and install PostgreSQL extensions:

content/docs/pig/install.md

@@ -47,7 +47,7 @@ curl -fsSL https://repo.pigsty.cc/pig | bash -s 1.0.0
 
 ## Download from Release Page
 
-You can also download `pig` installation packages (`RPM`/`DEB`/tarball) directly from the Pigsty repository: [GitHub Latest Release Page](https://github.com/pgsty/pig/releases/latest)
+You can also download `pig` installation packages (`RPM`/`DEB`/tarball) directly from the Pigsty repository: [GitHub v1.0.0 Stable Release Page](https://github.com/pgsty/pig/releases/tag/v1.0.0)
 
 ```
 latest
@@ -135,4 +135,3 @@ go get -u; go build
 ```
 
 All RPM/DEB packages are automatically built through GitHub CI/CD workflow using goreleaser.
-

content/docs/pig/intro.md

@@ -23,16 +23,9 @@ Want to supercharge your Postgres and escape the hassle? Visit the [PIG official
 turning your local Postgres database into an all-capable multi-modal data platform with one click.
 If [Postgres's future is unmatched extensibility](https://medium.com/@fengruohang/postgres-is-eating-the-database-world-157c204dcfc4), then Pig is the magic lamp that helps you unlock it. After all, no one ever complains about "too many extensions".
 
-## Agentic Native CLI
+## Automation-Friendly
 
-PIG is designed for AI agents and automation. The global `-o|--output` switch enables structured output (`yaml` / `json` / `json-pretty`),
-and Pig also provides the **Capability Map** and **Command Schema** needed for capability discovery.
-
-```bash
-pig --help -o yaml        # capability map
-pig ext --help -o json    # command schema
-pig repo list -o yaml     # structured result: success / code / message / data
-```
+PIG's command system is automation-ready out of the box: consistent argument conventions, stable output behavior, and `--dry-run` or confirmation flows for high-risk operations to reduce mistakes.
 
 
 > [ANNOUNCE pig: The Postgres Extension Wizard](https://www.postgresql.org/about/news/announce-pig-the-postgres-extension-wizard-2988/)

content/docs/pig/pb.md

@@ -27,7 +27,7 @@ Backup Commands (Primary Only):
   pig pb backup incr               incremental backup
 
 Restore Commands:
-  pig pb restore -d                restore to latest (default)
+  pig pb restore -d                restore to latest (end of WAL)
   pig pb restore -I                restore to backup consistency point
   pig pb restore -t <time>         restore to specific time
   pig pb restore -n <name>         restore to named restore point
@@ -97,7 +97,7 @@ Log Commands:
 ```bash
 # View backup info
 pig pb info                          # Show all backup info
-pig pb info -o json                  # JSON format output
+pig pb info --raw -o json            # Raw JSON output
 pig pb ls                            # List all backups
 pig pb ls repo                       # List configured repos
 pig pb ls stanza                     # List all stanzas
@@ -108,8 +108,8 @@ pig pb backup full                   # Full backup
 pig pb backup diff                   # Differential backup
 pig pb backup incr                   # Incremental backup
 
-# Restore (PITR)
-pig pb restore                       # Restore to latest (end of WAL)
+# Restore (PITR, at least one recovery target is required)
+pig pb restore -d                    # Restore to latest (end of WAL)
 pig pb restore -I                    # Restore to backup consistency point
 pig pb restore -t "2025-01-01 12:00:00+08"  # Restore to specific time
 pig pb restore -n savepoint          # Restore to named restore point
@@ -166,15 +166,16 @@ Show detailed backup repository info including all backup sets and WAL archive s
 
 ```bash
 pig pb info                          # Show all backup info
-pig pb info -o json                  # JSON format output
+pig pb info --raw -o json            # Raw JSON output
 pig pb info --set 20250101-120000F   # Show specific backup set details
 ```
 
 **Options:**
 
 | Option | Short | Description |
 |:---|:---|:---|
-| `--output` | `-o` | Output format: text, json |
+| `--raw` | `-R` | Raw output mode (pass through pgBackRest output) |
+| `--output` | `-o` | Output format: text, json (only in `--raw` mode) |
 | `--set` | | Show specific backup set details |
 {.full-width}
 
@@ -272,10 +273,10 @@ repo1-retention-archive=2            # WAL archive retention policy
 ### pb restore
 
 Restore from backup with point-in-time recovery (PITR) support.
+At least one recovery target (`-d/-I/-t/-n/-l/-x`) must be specified. Without parameters, help is shown.
 
 ```bash
 # Recovery target (mutually exclusive)
-pig pb restore                       # Restore to latest (default)
 pig pb restore -d                    # Restore to latest (explicit)
 pig pb restore -I                    # Restore to backup consistency point
 pig pb restore -t "2025-01-01 12:00:00+08"  # Restore to specific time

content/docs/pig/pg.md

@@ -38,7 +38,6 @@ Log Commands:
   pig pg log tail <logfile>        tail -f log file
   pig pg log cat  <logfile>        cat log file
   pig pg log less <logfile>        less log file
-  pig pg log grep <logfile> <pat>  grep log file
 
 Service Management (via systemctl):
   pig pg svc start                 start postgres service
@@ -92,9 +91,10 @@ Service Management (via systemctl):
 | `pg log tail` | `t, f` | Real-time log viewing | tail -f |
 | `pg log cat` | `c` | Output log content | |
 | `pg log less` | `vi, v` | View with less | |
-| `pg log grep` | `g, search` | Search logs | |
 {.full-width}
 
+> Known issue in `v1.0.0`: `pig pg log grep` has a parameter conflict and does not work. Use `pig pg log cat | grep PATTERN` as a workaround.
+
 **Service Subcommand** (`pg svc`):
 
 | Command | Alias | Description |
@@ -131,8 +131,8 @@ pig pg repack mydb                # Online repack database
 
 # Log viewing
 pig pg log tail                   # Real-time view latest log
-pig pg log grep ERROR             # Search error logs
 pig pg log list --log-dir /var/log/pg  # Custom log directory
+pig pg log cat | grep ERROR       # Filter logs in shell
 ```
 
 
@@ -562,26 +562,6 @@ pig pg log less postgresql.csv    # Open specific log file
 ```
 
 
-### pg log grep
-
-Search log files.
-
-```bash
-pig pg log grep ERROR             # Search for ERROR lines
-pig pg log grep -i error          # Case insensitive
-pig pg log grep -C 3 ERROR        # Show 3 lines context
-pig pg log grep ERROR pg.csv      # Search specific log file
-```
-
-**Options:**
-
-| Option | Short | Description |
-|:---|:---|:---|
-| `--ignore-case` | `-i` | Case insensitive |
-| `--context` | `-C` | Show N lines of context |
-{.full-width}
-
-
 ## pg svc Subcommand
 
 `pg svc` provides systemctl-based PostgreSQL service management: