docs(bsd): sync port examples to 1.0.0

Align FreeBSD/OpenBSD port docs with v1.0.0
tarballs and databases: (drop top-level db:).

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: hrodrig

contrib/BSD-PORTS-STEP-BY-STEP.md

@@ -91,8 +91,8 @@ Use when you want to test the port **before** GoReleaser publishes assets.
 
 1. Complete application release: **`make release-check`**, merge **`develop` → `main`**, tag **`v<VERSION>`**, CI/GoReleaser publishes assets.
 2. Confirm on [GitHub Releases](https://github.com/hrodrig/pgwd/releases), for example:
-   - `pgwd_v0.6.7_openbsd_amd64.tar.gz`
-   - `pgwd_v0.6.7_freebsd_amd64.tar.gz`
+   - `pgwd_v1.0.0_openbsd_amd64.tar.gz`
+   - `pgwd_v1.0.0_freebsd_amd64.tar.gz`
    - `.deb`, `.rpm`, Linux archives, container image, etc.
 3. **`gmake port-openbsd-sync`** (and **`port-freebsd-sync`** if needed) on **`main`** or **`develop`** at the released **`VERSION`**.
 4. On each BSD VM: refresh **`/usr/ports/sysutils/pgwd`**, **`make fetch`** (or copy distfile to **`DISTDIR`**), **`make makesum`**, **`make package FETCH_PACKAGES=No`**, **`make install`**.

contrib/freebsd/PORT-RELEASE.md

@@ -11,7 +11,7 @@ Steps to create or update the pgwd port for a new release.
 
 **`ONLY_FOR_ARCHS`** in the port **`Makefile`** must match assets on the GitHub release for that **`PORTVERSION`**:
 
-| FreeBSD `ARCH` | Release tarball suffix | In release today (v0.6.7) |
+| FreeBSD `ARCH` | Release tarball suffix | In release today (v1.0.0) |
 |----------------|------------------------|---------------------------|
 | amd64 | `_freebsd_amd64` | yes |
 | aarch64 | `_freebsd_arm64` | yes |
@@ -23,7 +23,7 @@ QA for Bugzilla: document the FreeBSD version and arch you tested (e.g. FreeBSD
 
 1. **Bump version** in `contrib/freebsd/Makefile`:
    ```bash
-   # Edit PORTVERSION=	0.5.10  →  new version
+   # Edit PORTVERSION=	1.0.0  →  new version
    ```
 
 2. **Commit and release** pgwd (tag, `make release`). The GitHub release must include **`pgwd_vX.Y.Z_freebsd_amd64.tar.gz`** and **`pgwd_vX.Y.Z_freebsd_arm64.tar.gz`** (see **Supported architectures**). Goreleaser does not publish **freebsd/riscv64** today.
@@ -41,7 +41,7 @@ QA for Bugzilla: document the FreeBSD version and arch you tested (e.g. FreeBSD
 1. **Create/checkout branch:**
    ```bash
    cd ~/ports
-   git checkout -b add-pgwd-port   # or update-pgwd-0.5.11 for updates
+   git checkout -b add-pgwd-port   # or update-pgwd-1.0.0 for updates
    ```
 
 2. **Update files** (if not already copied):
@@ -77,7 +77,7 @@ QA for Bugzilla: document the FreeBSD version and arch you tested (e.g. FreeBSD
 7. **Commit:**
    ```bash
    git add sysutils/pgwd/
-   git commit -m "New port: sysutils/pgwd - Postgres Watch Dog"   # or "Update sysutils/pgwd to 0.5.11"
+   git commit -m "New port: sysutils/pgwd - Postgres Watch Dog"   # or "Update sysutils/pgwd to 1.0.0"
    ```
 
 8. **Submit to Bugzilla:**
@@ -100,7 +100,7 @@ QA for Bugzilla: document the FreeBSD version and arch you tested (e.g. FreeBSD
 
 | Variable | Example |
 |----------|---------|
-| PORTVERSION | 0.6.7 |
+| PORTVERSION | 1.0.0 |
 | ONLY_FOR_ARCHS | amd64 aarch64 |
 | DISTFILES | pgwd_v${PORTVERSION}_freebsd_${ARCH:S/aarch64/arm64/}.tar.gz |
 | MASTER_SITES | https://github.com/hrodrig/pgwd/releases/download/v${PORTVERSION}/ |

contrib/freebsd/README.md

@@ -42,7 +42,7 @@ After `make install` (or `make reinstall`), verify the installed binary:
 pgwd -version
 ```
 
-If `make install` reports that an older package is already installed (for example `pgwd-0.5.10`), use:
+If `make install` reports that an older package is already installed (for example `pgwd-0.6.8`), use:
 
 ```bash
 make reinstall
@@ -54,15 +54,15 @@ This deinstalls the previous package and registers the new one cleanly.
 
 The port normally fetches **DISTFILES** from **MASTER_SITES** (GitHub releases). To build or test **install** / **plist** against a tarball you built locally (no matching release on GitHub yet):
 
-1. **Match the filename** in **DISTFILES** for your architecture (e.g. `pgwd_v0.6.4_freebsd_amd64.tar.gz` when **PORTVERSION** is `0.6.4`). From the pgwd repo root, **`make port-freebsd-sync`** updates **PORTVERSION** in this **Makefile** from the **`VERSION`** file.
+1. **Match the filename** in **DISTFILES** for your architecture (e.g. `pgwd_v1.0.0_freebsd_amd64.tar.gz` when **PORTVERSION** is `1.0.0`). From the pgwd repo root, **`make port-freebsd-sync`** updates **PORTVERSION** in this **Makefile** from the **`VERSION`** file.
 
    To generate that exact tarball layout/name locally (without running the full snapshot matrix), run from repo root:
 
    ```bash
    make dist-freebsd
    ```
 
-   Output goes to `dist/pgwd_v<version>_freebsd_<arch>.tar.gz` using `VERSION` (for example `dist/pgwd_v0.6.4_freebsd_amd64.tar.gz`).
+   Output goes to `dist/pgwd_v<version>_freebsd_<arch>.tar.gz` using `VERSION` (for example `dist/pgwd_v1.0.0_freebsd_amd64.tar.gz`).
 
 2. **Option A — copy into DISTDIR:** From the port directory:
 
@@ -79,7 +79,7 @@ The port normally fetches **DISTFILES** from **MASTER_SITES** (GitHub releases).
    ```bash
    cd ~/ports/sysutils/pgwd
    mkdir -p /tmp/pgwd-dist
-   cp /path/to/pgwd/dist/pgwd_v0.6.4_freebsd_amd64.tar.gz /tmp/pgwd-dist/
+   cp /path/to/pgwd/dist/pgwd_v1.0.0_freebsd_amd64.tar.gz /tmp/pgwd-dist/
    make makesum MASTER_SITES=file:///tmp/pgwd-dist/
    make fetch MASTER_SITES=file:///tmp/pgwd-dist/
    make install
@@ -102,7 +102,7 @@ pgwd reads `/etc/pgwd/pgwd.conf` by default. Copy the example and edit:
 ```bash
 mkdir -p /etc/pgwd
 cp /usr/local/etc/pgwd/pgwd.conf.example /etc/pgwd/pgwd.conf
-vi /etc/pgwd/pgwd.conf   # client, db.url, notifications, etc.
+vi /etc/pgwd/pgwd.conf   # client, databases[].url, notifications, etc.
 ```
 
 ## Daemon (rc.d)
@@ -206,10 +206,10 @@ interval: 60
 dry_run: false
 
 # Deprecated: DISCOVER_MY_PASSWORD removed in 0.9.x — use Secret-backed password in URL
-db:
-  url: "postgres://postgres:YOUR_PASSWORD@localhost:25432/mydb"
-  threshold:
-    levels: "75,85,95"
+databases:
+  - url: "postgres://postgres:YOUR_PASSWORD@localhost:25432/mydb"
+    threshold:
+      levels: "75,85,95"
 
 kube:
   context: "my-context"

contrib/openbsd/PORT-RELEASE.md

@@ -95,8 +95,8 @@ Use **BSD `make`** inside **`/usr/ports/sysutils/pgwd`**, not **`gmake`** from t
 
 ```sh
 cd /usr/ports/sysutils/pgwd
-ver=$(make -V PKGNAME | sed 's/^pgwd-//')    # e.g. 0.6.7
-dist=$(make -V DISTFILES)                     # e.g. pgwd_v0.6.7_openbsd_amd64.tar.gz
+ver=$(make -V PKGNAME | sed 's/^pgwd-//')    # e.g. 1.0.0
+dist=$(make -V DISTFILES)                     # e.g. pgwd_v1.0.0_openbsd_amd64.tar.gz
 echo "PKGNAME=$ver DISTFILES=$dist"
 ```
 
@@ -234,7 +234,7 @@ rcctl enable pgwd
 ```sh
 mkdir -p /etc/pgwd
 cp /usr/local/share/examples/pgwd/pgwd.conf.example /etc/pgwd/pgwd.conf
-vi /etc/pgwd/pgwd.conf    # db.url, client, notifications, etc.
+vi /etc/pgwd/pgwd.conf    # databases[].url, client, notifications, etc.
 
 rcctl start pgwd
 rcctl check pgwd          # expect pgwd(ok)
@@ -256,7 +256,7 @@ make test-platforms-ping PLATFORM=pgwd-openbsd
 make test-platforms PLATFORM=pgwd-openbsd
 ```
 
-Set **`pgwd_version`** in **`testing/platforms/inventory/hosts.yml`** to match the release (e.g. **`0.6.7`**) or use **`pgwd_local_package`** pointing at **`dist/pgwd_v...tar.gz`**.
+Set **`pgwd_version`** in **`testing/platforms/inventory/hosts.yml`** to match the release (e.g. **`1.0.0`**) or use **`pgwd_local_package`** pointing at **`dist/pgwd_v...tar.gz`**.
 
 ### B8. Port vs tarball (rc.d location)
 
@@ -268,7 +268,7 @@ Set **`pgwd_version`** in **`testing/platforms/inventory/hosts.yml`** to match t
 ### B9. Lab shortcut (no full ports tree)
 
 ```sh
-doas sh /tmp/pgwd-port/test-install-from-dist.sh /tmp/pgwd_v0.6.7_openbsd_amd64.tar.gz /tmp/pgwd-port
+doas sh /tmp/pgwd-port/test-install-from-dist.sh /tmp/pgwd_v1.0.0_openbsd_amd64.tar.gz /tmp/pgwd-port
 ```
 
 Useful for debugging **do-install** layout; **not** a substitute for **B5** before submitting the port.

contrib/openbsd/README.md

@@ -26,7 +26,7 @@ The release tarball (`pgwd_v*_openbsd_amd64.tar.gz`) includes the rc.d script at
 
 ```bash
 # Extract and install binary
-tar xzf pgwd_v0.5.10_openbsd_amd64.tar.gz
+tar xzf pgwd_v1.0.0_openbsd_amd64.tar.gz
 doas install -m755 pgwd /usr/local/bin/
 
 # Copy rc.d script (from tarball)
@@ -35,7 +35,7 @@ doas install -m555 share/openbsd/rc.d/pgwd /etc/rc.d/pgwd
 # Config (required; tarball includes etc/pgwd/pgwd.conf.example)
 doas mkdir -p /etc/pgwd
 doas cp etc/pgwd/pgwd.conf.example /etc/pgwd/pgwd.conf
-doas vi /etc/pgwd/pgwd.conf  # edit client, db.url, etc.
+doas vi /etc/pgwd/pgwd.conf  # edit client, databases[].url, etc.
 
 # Enable and start
 doas rcctl enable pgwd
@@ -82,10 +82,10 @@ interval: 60
 dry_run: false
 
 # Deprecated: DISCOVER_MY_PASSWORD removed in 0.9.x — use Secret-backed password in URL
-db:
-  url: "postgres://postgres:YOUR_PASSWORD@localhost:25432/mydb"
-  threshold:
-    levels: "75,85,95"
+databases:
+  - url: "postgres://postgres:YOUR_PASSWORD@localhost:25432/mydb"
+    threshold:
+      levels: "75,85,95"
 
 kube:
   context: "my-context"       # Use context name from kubeconfig, not cluster name
@@ -105,7 +105,7 @@ notifications:
 
 **Grafana:** Loki logs include a `client` label. Filter by `{app="pgwd", client="pgwd-vps-01"}` to see logs from this instance.
 
-**Troubleshooting:** If you see "context X does not exist", use the **context** name from `kubectl config get-contexts`, not the cluster name. The `db.url` host must be `localhost` and the port must match `kube.local_port`.
+**Troubleshooting:** If you see "context X does not exist", use the **context** name from `kubectl config get-contexts`, not the cluster name. The database URL host must be `localhost` and the port must match `kube.local_port`.
 
 ## Commands
 

contrib/openbsd/port/README.md

@@ -116,7 +116,7 @@ pgwd -config /etc/pgwd/pgwd.conf -dry-run -interval 0
 
 ## Test with a local tarball (before a GitHub release)
 
-1. Match **DISTFILES** (e.g. **`pgwd_v0.6.7_openbsd_amd64.tar.gz`** after **`gmake port-openbsd-sync`**).
+1. Match **DISTFILES** (e.g. **`pgwd_v1.0.0_openbsd_amd64.tar.gz`** after **`gmake port-openbsd-sync`**).
 
 2. Build from repo root:
 
@@ -130,7 +130,7 @@ pgwd -config /etc/pgwd/pgwd.conf -dry-run -interval 0
 4. **Option B — `file://`:**
 
    ```sh
-   cp /path/to/pgwd/dist/pgwd_v0.6.7_openbsd_amd64.tar.gz /tmp/pgwd-dist/
+   cp /path/to/pgwd/dist/pgwd_v1.0.0_openbsd_amd64.tar.gz /tmp/pgwd-dist/
    cd /usr/ports/sysutils/pgwd
    make fetch MASTER_SITES=file:///tmp/pgwd-dist/
    make install

contrib/openbsd/port/test-install-from-dist.sh

@@ -2,7 +2,7 @@
 # Install pgwd like the OpenBSD port (do-install + @rcscript) without a full /usr/ports tree.
 # Use on lab VMs that only have the port skeleton + local distfile.
 #
-#   doas sh test-install-from-dist.sh /tmp/pgwd_v0.6.7_openbsd_amd64.tar.gz
+#   doas sh test-install-from-dist.sh /tmp/pgwd_v1.0.0_openbsd_amd64.tar.gz
 #
 # Optional second arg: directory containing files/pgwd (default: script dir, then files/)