docs: add technical docstrings and harden pr-check-test-files.sh

Signed-off-by: Dominiq Barbero <mr.dom.barbero@gmail.com>

Author: MrMadHatt

.github/scripts/pr-check-test-files.sh

@@ -1,4 +1,41 @@
 #!/usr/bin/env bash
+set -euo pipefail
+
+# ======================================================================================================================================================
+# @file: pr-check-test-files.sh
+#
+# @Description A CI check written in bash that enforces the '_test.py' suffix to ensure Pytest can automatically discover 
+#               new or renamed test files in a Pull Request. 
+# 
+# @logic: 
+# 1. Identifies files as (A) Added, (R) Renamed, or (C) Copied using 'git diff' to check 
+#    relevant filename ($file1 for added files, $file2 for renamed/copied files). 
+# 2. Validates paths against allowed test directories (unit/integration).
+# 3. Excludes specific utility (ex., conftest.py, utils.py) and non-Python files.
+# 4. Parses tab-separated Git output via IFS=$'\t' to ensure robust filename handling.
+# 5. Routes files using case statement based on git status
+#
+# @types:
+# - String: Used for file paths and git status codes. 
+# - Array: Used for 'TEST_DIRS', 'EXCEPTION_NAMES', and accumulating errors.
+#
+# @Parameters:
+# - None: This script does not accept CLI arguments. It derives the input from the current Git state compared against origin/main.
+#  
+# @Dependencies:
+# - Git: (for diff)
+# - Bash: (runs the script)
+# - Pytest: (naming standard)
+#
+# @Permissions:
+# - Requires Execute permissions (chmod +x) to run. Also needs Read access to the git repository to perform the diff.
+#
+# @Return
+# - 0: All test files follow the naming standard.
+# - 1: Exits with status 1 and outputs error messages in red.
+#      Includes a yellow instructional block providing reason why the file failed.
+# ======================================================================================================================================================
+
 RED="\033[31m"
 YELLOW="\033[33m"
 RESET="\033[0m"

CHANGELOG.md

@@ -80,15 +80,13 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - Added support for include duplicates in get transaction receipt query (#1166)
 - Added `.github/workflows/cron-check-broken-links.yml` workflow to perform scheduled monthly Markdown link validation across the entire repository with automatic issue creation for broken links ([#1210](https://github.com/hiero-ledger/hiero-sdk-python/issues/1210))
 - Added `transfer_transaction_tinybar.py` example demonstrating tinybar transfers with both integer and Hbar object approaches. ([#1249](https://github.com/hiero-ledger/hiero-sdk-python/issues/1249))
-- Added `transfer_transaction_gigabar.py` example demonstrating `GIGABAR` unit usage for large-value transfers. ([#1249](https://github.com/hiero-ledger/hiero-sdk-python/issues/1249))
-- Coderabbit prompt for .github
-- Added convenient factory methods to `Hbar` class for easier instantiation: `from_microbars()`, `from_millibars()`, `from_hbars()`, `from_kilobars()`, `from_megabars()`, and `from_gigabars()`. [#1272](https://github.com/hiero-ledger/hiero-sdk-python/issues/1272)
 - Added merge conflict bot workflow (`.github/workflows/bot-merge-conflict.yml`) and helper script (`.github/scripts/bot-merge-conflict.js`) to detect and notify about PR merge conflicts, with retry logic for unknown mergeable states, idempotent commenting, and push-to-main recheck logic (#1247)
 - Added workflow to prevent assigning intermediate issues to contributors without prior Good First Issue completion (#1143).
 - Added `Client.from_env()` and network-specific factory methods (e.g., `Client.for_testnet()`) to simplify client initialization and reduce boilerplate. [[#1251](https://github.com/hiero-ledger/hiero-sdk-python/issues/1251)]
 - Improved unit test coverage for `TransactionId` class, covering parsing logic, hashing, and scheduled transactions.
 - Chained Good First Issue assignment with mentor assignment to bypass GitHub's anti-recursion protection - mentor assignment now occurs immediately after successful user assignment in the same workflow execution. (#1369)
 - Add GitHub Actions script and workflow for automatic spam list updates.
+- Added technical docstrings and hardening (set -euo pipefail) to the pr-check-test-files.sh script
 
 ### Changed
 - Added global review instructions to CodeRabbit configuration to limit reviews to issue/PR scope and prevent scope creep [#1373]