style(comments): enforce third-person singular and spacing

- Apply third-person singular wording in inline comments across touched scripts.

- Add vertical gaps before standalone comment lines in function bodies.

- Update agent guidance and refresh README links to match source layout.

Author: rdavid

AGENTS.md

@@ -34,7 +34,9 @@ file already depends on them. Follow the existing editor hints: 2-space
 indentation, no tabs, and an approximately 79-character text width. Public
 functions in `lib/base.sh` are unprefixed, internal helpers use `base_`, and
 global variables use the `BASE_` prefix. Keep new test files aligned with the
-current pattern, for example `app/test-realpath-ok`.
+current pattern, for example `app/test-realpath-ok`. Write comments in
+third-person singular, and place a vertical gap before standalone comment lines
+inside function bodies.
 
 ## Testing Guidelines
 

README.adoc

@@ -128,9 +128,9 @@ The public functions are, in alphabetical order:
 {url-base}#L866[`validate_cmd`],
 {url-base}#L873[`validate_var`],
 {url-base}#L880[`var_exists`],
-{url-base}#L914[`ver_ge`],
-{url-base}#L922[`vid2aud`],
-{url-base}#L936[`ytda`].
+{url-base}#L916[`ver_ge`],
+{url-base}#L924[`vid2aud`],
+{url-base}#L938[`ytda`].
 
 Global variables have the `BASE_` prefix and can be used by clients.
 Clients should place temporary files under `$BASE_WIP`.

app/install

@@ -7,15 +7,16 @@ set -- "$@" --quiet
 BSH="$(
 	CDPATH='' cd -- "$(dirname -- "$0" 2>&1)" 2>&1 && pwd -P 2>&1
 )"/../lib/base.sh || {
-	# Capture status before printf; local is invalid outside functions.
+
+	# Captures status before printf; local is invalid outside functions.
 	err=$?
 	printf >&2 %s\\n "$BSH"
 	exit "$err"
 }
 
 # shellcheck disable=SC2034 # Variable appears unused.
 readonly \
-	BASE_APP_VERSION=0.9.20260402 \
+	BASE_APP_VERSION=0.9.20260409 \
 	BASE_MIN_VERSION=0.9.20240831 \
 	BSH \
 	DST=/usr/local/bin \

lib/base.sh

@@ -47,7 +47,7 @@ BASE_RC_CON_NO=14
 BASE_RC_CON_TO=13
 BASE_RC_DIE_NO=10
 BASE_SHOULD_CON=false
-BASE_VERSION=0.9.20260407
+BASE_VERSION=0.9.20260409
 
 # Removes any file besides mp3, m4a, flac in the current directory.
 # Removes empty directories.
@@ -880,6 +880,7 @@ validate_var() {
 var_exists() {
 	local arg ret=0 var
 	for arg; do
+
 		# Accepts only POSIX identifiers: [A-Za-z_][A-Za-z0-9_]*.
 		case "$arg" in
 		'' | [!A-Za-z_]* | *[!A-Za-z0-9_]*)
@@ -888,6 +889,7 @@ var_exists() {
 			continue
 			;;
 		esac
+
 		# ${name-} expands to empty when name is undefined and avoids nounset
 		# failures under set -o nounset.
 		eval "var=\${$arg-}" || {
@@ -1389,6 +1391,7 @@ for arg; do
 	-x | --execute) set -x ;;
 	-y | --yes) BASE_SHOULD_CON=true ;;
 	*)
+
 		# If an argument is not skipped, sets it back to all.
 		if [ $skp = false ]; then
 			set -- "$@" "$arg"

test.do

@@ -13,7 +13,7 @@ BSH="$(
 
 # shellcheck disable=SC2034 # Variable appears unused.
 readonly \
-	BASE_APP_VERSION=0.9.20250819 \
+	BASE_APP_VERSION=0.9.20260409 \
 	BASE_MIN_VERSION=0.9.20231228 \
 	BSH
 set -- "$@" --quiet
@@ -27,6 +27,7 @@ for sh in ash bash dash fish ksh oksh tcsh yash zsh; do
 		"$sh" -c "$ok 2>&1" || die "$ok" on "$sh" returns negative.
 	done
 	for no in ./app/*-no; do
+
 		# shellcheck disable=SC2015 # A && B || C.
 		"$sh" -c "$no 2>&1" && die "$no" on "$sh" returns positive. || :
 	done