From b8b142dcb2b99e7fb6cd2bb11264241e3fa1cdd5 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 23 Dec 2025 23:05:55 -0600
Subject: [PATCH] Update update_dates.sh

---
 scripts/update_dates.sh | 105 ++++++++++++++++++++++++++++++----------
 1 file changed, 79 insertions(+), 26 deletions(-)

diff --git a/scripts/update_dates.sh b/scripts/update_dates.sh
index db878f3..879c352 100644
--- a/scripts/update_dates.sh
+++ b/scripts/update_dates.sh
@@ -24,55 +24,108 @@
 # INGROUP: Date.Normalization
 # REPO: https://github.com/mokoconsulting-tech/MokoStandards
 # PATH: /scripts/update_dates.sh
-# VERSION: 01.00.00
+# VERSION: 01.00.01
 # BRIEF: Normalize release dates across manifests and CHANGELOG using a single authoritative UTC date.
-# NOTE: Repo-controlled script only. No fallback logic. CI-fatal on malformed inputs.
+# NOTE: Repo-controlled script only. CI-fatal on malformed inputs. Outputs a JSON report to stdout.
 
 set -euo pipefail
 
 TODAY_UTC="${1:-}"
 VERSION="${2:-}"
 
+usage() {
+  echo "ERROR: Usage: update_dates.sh <YYYY-MM-DD> <VERSION>" >&2
+}
+
 if [ -z "${TODAY_UTC}" ] || [ -z "${VERSION}" ]; then
-	echo "ERROR: Usage: update_dates.sh <YYYY-MM-DD> <VERSION>" >&2
-	exit 1
+  usage
+  exit 1
 fi
 
 # Validate date format strictly
 if ! echo "${TODAY_UTC}" | grep -Eq '^[0-9]{4}-[0-9]{2}-[0-9]{2}$'; then
-	echo "ERROR: Invalid date format. Expected YYYY-MM-DD, got '${TODAY_UTC}'" >&2
-	exit 1
+  echo "ERROR: Invalid date format. Expected YYYY-MM-DD, got '${TODAY_UTC}'" >&2
+  exit 1
 fi
 
 # Validate version format strictly
 if ! echo "${VERSION}" | grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+$'; then
-	echo "ERROR: Invalid version format. Expected X.Y.Z, got '${VERSION}'" >&2
-	exit 1
+  echo "ERROR: Invalid version format. Expected X.Y.Z, got '${VERSION}'" >&2
+  exit 1
 fi
 
+# Cross-platform sed in-place helper (GNU and BSD)
+# - Ubuntu runners use GNU sed, but this keeps local execution deterministic.
+sed_inplace() {
+  local expr="$1"
+  local file="$2"
+
+  if sed --version >/dev/null 2>&1; then
+    sed -i -E "${expr}" "${file}"
+  else
+    sed -i '' -E "${expr}" "${file}"
+  fi
+}
+
 echo "Normalizing dates to ${TODAY_UTC} for version ${VERSION}"
 
 # Update CHANGELOG.md heading date
-if [ -f CHANGELOG.md ]; then
-	if grep -Eq "^## \\[${VERSION}\\]" CHANGELOG.md; then
-		sed -i -E "s#^(## \\[${VERSION}\\]) .*#\\1 ${TODAY_UTC}#" CHANGELOG.md
-	else
-		echo "ERROR: CHANGELOG.md does not contain heading for version [${VERSION}]" >&2
-		exit 1
-	fi
-else
-	echo "ERROR: CHANGELOG.md not found" >&2
-	exit 1
+if [ ! -f CHANGELOG.md ]; then
+  echo "ERROR: CHANGELOG.md not found" >&2
+  exit 1
 fi
 
+if ! grep -Eq "^## \[${VERSION}\]" CHANGELOG.md; then
+  echo "ERROR: CHANGELOG.md does not contain heading for version [${VERSION}]" >&2
+  exit 1
+fi
+
+# Use a delimiter that will not collide with the pattern (the heading starts with "##")
+sed_inplace "s|^(## \[${VERSION}\]) .*|\1 ${TODAY_UTC}|" CHANGELOG.md
+
 # Update XML manifest dates
-find . -type f -name "*.xml" \
-	-not -path "./.git/*" \
-	-not -path "./.github/*" \
-	-print0 | while IFS= read -r -d '' FILE; do
-		sed -i "s#<creationDate>[^<]*</creationDate>#<creationDate>${TODAY_UTC}</creationDate>#g" "${FILE}" || true
-		sed -i "s#<date>[^<]*</date>#<date>${TODAY_UTC}</date>#g" "${FILE}" || true
-		sed -i "s#<buildDate>[^<]*</buildDate>#<buildDate>${TODAY_UTC}</buildDate>#g" "${FILE}" || true
-	done
+XML_SCANNED=0
+XML_TOUCHED=0
+
+while IFS= read -r -d '' FILE; do
+  XML_SCANNED=$((XML_SCANNED + 1))
+
+  BEFORE_HASH=""
+  AFTER_HASH=""
+
+  # Best-effort content hash for change detection without external deps.
+  if command -v sha256sum >/dev/null 2>&1; then
+    BEFORE_HASH="$(sha256sum "${FILE}" | awk '{print $1}')"
+  fi
+
+  # Use # delimiter because XML does not include # in these tags.
+  sed -i "s#<creationDate>[^<]*</creationDate>#<creationDate>${TODAY_UTC}</creationDate>#g" "${FILE}" || true
+  sed -i "s#<date>[^<]*</date>#<date>${TODAY_UTC}</date>#g" "${FILE}" || true
+  sed -i "s#<buildDate>[^<]*</buildDate>#<buildDate>${TODAY_UTC}</buildDate>#g" "${FILE}" || true
+
+  if [ -n "${BEFORE_HASH}" ]; then
+    AFTER_HASH="$(sha256sum "${FILE}" | awk '{print $1}')"
+    if [ "${BEFORE_HASH}" != "${AFTER_HASH}" ]; then
+      XML_TOUCHED=$((XML_TOUCHED + 1))
+    fi
+  fi
+
+done < <(
+  find . -type f -name "*.xml" \
+    -not -path "./.git/*" \
+    -not -path "./.github/*" \
+    -not -path "./dist/*" \
+    -not -path "./node_modules/*" \
+    -print0
+)
+
+# JSON report to stdout (workflow can capture or include in summary)
+printf '{"today_utc":"%s","version":"%s","changelog":"%s","xml_scanned":%s,"xml_touched":%s}
+' \
+  "${TODAY_UTC}" \
+  "${VERSION}" \
+  "CHANGELOG.md" \
+  "${XML_SCANNED}" \
+  "${XML_TOUCHED}"
 
 echo "Date normalization complete."