feat(M2): Documentation flow, accuracy, consistency cleanup, and cross-platform shell portability

scripts/verify-pi-resources.sh

@@ -1,6 +1,9 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+# shellcheck source=lib/portable.sh
+source "$(dirname "${BASH_SOURCE[0]}")/lib/portable.sh"
+
 REQUIRED_FILES=(
   "docs/PI-RESEARCH.md"
   "docs/PI.md"
@@ -84,7 +87,7 @@ for family in atlassian create-plan do-task implement-plan web-automation; do
     rel_path=${source_path#"$source_dir"/}
     mirror_path="${mirror_dir}/${rel_path}"
     test -e "$mirror_path"
-    test "$(stat -f '%Lp' "$source_path")" = "$(stat -f '%Lp' "$mirror_path")"
+    test "$(portable_stat_perms "$source_path")" = "$(portable_stat_perms "$mirror_path")"
   done < <(find "$source_dir" \
     \( -name '.DS_Store' -o -name 'node_modules' \) -prune -o \
     -mindepth 1 -print0)