Implement core script improvements

- Add joomla_manifest.sh library with manifest parsing functions
- Add smoke_test.sh for repository validation
- Add versions.sh for version management
- Add JSON utilities to common.sh
- Fix logging.sh with proper enhanced logging functions
- Make all scripts executable

Co-authored-by: jmiller-moko <230051081+jmiller-moko@users.noreply.github.com>

scripts/fix/versions.sh

@@ -0,0 +1,150 @@
+#!/usr/bin/env bash
+
+# ============================================================================
+# Copyright (C) 2025 Moko Consulting <hello@mokoconsulting.tech>
+#
+# This file is part of a Moko Consulting project.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program (./LICENSE.md).
+# ============================================================================
+
+# ============================================================================
+# FILE INFORMATION
+# ============================================================================
+# DEFGROUP: Script.Fix
+# INGROUP: Version.Management
+# REPO: https://github.com/mokoconsulting-tech/moko-cassiopeia
+# PATH: /scripts/fix/versions.sh
+# VERSION: 01.00.00
+# BRIEF: Update version numbers across repository files
+# NOTE: Updates manifest, package.json, and other version references
+# ============================================================================
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+. "${SCRIPT_DIR}/lib/common.sh"
+
+# ----------------------------------------------------------------------------
+# Usage and validation
+# ----------------------------------------------------------------------------
+
+usage() {
+cat <<-USAGE
+Usage: $0 <VERSION>
+
+Update version numbers across repository files.
+
+Arguments:
+  VERSION    Semantic version in format X.Y.Z (e.g., 3.5.0)
+
+Examples:
+  $0 3.5.0
+  $0 1.2.3
+USAGE
+exit 1
+}
+
+validate_version() {
+local v="$1"
+if ! printf '%s' "$v" | grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+$'; then
+die "Invalid version format: $v (expected X.Y.Z)"
+fi
+}
+
+# ----------------------------------------------------------------------------
+# Main
+# ----------------------------------------------------------------------------
+
+[ $# -eq 1 ] || usage
+
+VERSION="$1"
+validate_version "${VERSION}"
+
+log_info "Updating version to: ${VERSION}"
+
+# Source Joomla manifest utilities
+. "${SCRIPT_DIR}/lib/joomla_manifest.sh"
+
+# Find and update manifest
+MANIFEST="$(find_manifest src)"
+log_info "Updating manifest: ${MANIFEST}"
+
+# Cross-platform sed helper
+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
+}
+
+# Update version in manifest XML
+if grep -q '<version>' "${MANIFEST}"; then
+sed_inplace "s|<version>[^<]*</version>|<version>${VERSION}</version>|g" "${MANIFEST}"
+log_info "✓ Updated manifest version"
+else
+log_warn "No <version> tag found in manifest"
+fi
+
+# Update package.json if it exists
+if [ -f "package.json" ]; then
+if command -v python3 >/dev/null 2>&1; then
+python3 - <<PY "${VERSION}"
+import json
+import sys
+
+version = sys.argv[1]
+
+try:
+with open('package.json', 'r') as f:
+data = json.load(f)
+
+data['version'] = version
+
+with open('package.json', 'w') as f:
+json.dump(data, f, indent=2)
+f.write('\n')
+
+print(f"✓ Updated package.json to version {version}")
+except Exception as e:
+print(f"WARN: Failed to update package.json: {e}")
+sys.exit(0)
+PY
+fi
+fi
+
+# Update README.md version references
+if [ -f "README.md" ]; then
+# Look for version references in format VERSION: XX.XX.XX
+if grep -q 'VERSION: [0-9]' README.md; then
+# Convert to zero-padded format if needed
+PADDED_VERSION="$(printf '%s' "${VERSION}" | awk -F. '{printf "%02d.%02d.%02d", $1, $2, $3}')"
+sed_inplace "s|VERSION: [0-9]{2}\.[0-9]{2}\.[0-9]{2}|VERSION: ${PADDED_VERSION}|g" README.md
+log_info "✓ Updated README.md version references"
+fi
+fi
+
+log_info "========================================="
+log_info "Version update completed: ${VERSION}"
+log_info "Files updated:"
+log_info "  - ${MANIFEST}"
+[ -f "package.json" ] && log_info "  - package.json"
+[ -f "README.md" ] && log_info "  - README.md"
+log_info "========================================="