fix(swift-doc-coverage): gracefully skip when swift-docc-plugin is missing

SwiftPM returns exit 64 with stderr `Unknown subcommand or plugin name

'generate-documentation'` when the package plugin that provides the

subcommand isn't on the consumer Package.swift's dependency list. The

hook now detects that exact error and emits a one-line skip notice

pointing at the missing dependency, matching the existing 'swift not on

PATH' skip path. Without this, every consumer repo whose Package.swift

does not declare swift-docc-plugin fails CI Lint on every commit.

Also adds .typos.toml with BRE/ERE POSIX acronyms allow-listed so a

pre-existing CHANGELOG entry stops tripping the typos hook on touch.

Author: Goldziher

.typos.toml

@@ -0,0 +1,4 @@
+[default.extend-words]
+# Technical acronyms that typos misidentifies.
+BRE = "BRE"  # Basic Regular Expression (POSIX)
+ERE = "ERE"  # Extended Regular Expression (POSIX)

CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.19] - 2026-05-26
+
+### Added
+
+- `.typos.toml` with `BRE`/`ERE` POSIX regex acronyms allow-listed so the
+  typos hook stops flagging legitimate technical terms used in CHANGELOG and
+  hook documentation. (`.typos.toml`)
+
 ### Changed
 
 - Bump pinned versions in `.pre-commit-config.yaml`: `astral-sh/ruff-pre-commit`
@@ -16,6 +24,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+- `swift-doc-coverage`: gracefully skip when `swift-docc-plugin` is not a
+  declared dependency of the target `Package.swift`. SwiftPM returns exit 64
+  with stderr `Unknown subcommand or plugin name 'generate-documentation'`
+  when the package plugin that provides the subcommand isn't on the package's
+  dependency list. The hook now detects that exact error and emits a one-line
+  skip notice (pointing at the missing dependency) instead of failing the
+  commit, matching the existing "swift not on PATH" skip behaviour. Without
+  this, every consumer repo that ships a Package.swift without DocC support
+  fails CI Lint on every commit. (`hooks/swift-doc-coverage/run.sh`)
+
 - `oxfmt`: refresh v1.66.0 checksums after the upstream asset changed from the
   stale v1.64.0 digest. This fixes checksum failures on macOS arm64 consumers.
   (`hooks/oxfmt/checksums.txt`)

hooks/swift-doc-coverage/run.sh

@@ -5,6 +5,9 @@
 # --warnings-as-errors`. Captures stderr for "missing documentation" or
 # "broken documentation link" warnings and fails on any match.
 # If `swift` is not on PATH or no Package.swift is found, exits 0.
+# shellcheck disable=SC2016
+# Single-quoted printf messages intentionally contain literal backticks to
+# render tool/path names in the shell output; we do not want shell expansion.
 set -euo pipefail
 
 if ! command -v swift >/dev/null 2>&1; then
@@ -71,6 +74,21 @@ for root in "${roots[@]}"; do
   rc=$?
   set -e
 
+  # `swift package generate-documentation` is provided by the swift-docc-plugin
+  # package plugin. When the consumer's Package.swift does not declare
+  # `swift-docc-plugin` as a dependency, SwiftPM returns exit 64 with stderr
+  # `Unknown subcommand or plugin name 'generate-documentation'`. The hook
+  # cannot enforce doc coverage in that case, so emit a one-line skip notice
+  # pointing at the missing dependency and move on instead of failing the
+  # commit. This matches the existing "swift not on PATH" skip behaviour.
+  if ((rc != 0)) && grep -E -q "Unknown subcommand or plugin name .?generate-documentation" "${log_file}"; then
+    printf 'swift-doc-coverage: skipping %s — swift-docc-plugin is not declared as a Package.swift dependency.\n' "${root}" >&2
+    printf "  add \`.package(url: \"https://github.com/swiftlang/swift-docc-plugin\", from: \"1.4.0\")\` to enable this hook.\n" >&2
+    rm -f "${log_file}"
+    trap - EXIT
+    continue
+  fi
+
   cat "${log_file}" >&2
 
   if ((rc != 0)); then