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/run/smoke_test.sh

@@ -0,0 +1,146 @@
+#!/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.Test
+# INGROUP: Repository.Validation
+# REPO: https://github.com/mokoconsulting-tech/moko-cassiopeia
+# PATH: /scripts/run/smoke_test.sh
+# VERSION: 01.00.00
+# BRIEF: Basic smoke tests to verify repository structure and manifest validity
+# NOTE: Quick validation checks for essential repository components
+# ============================================================================
+
+set -euo pipefail
+
+# Source common utilities
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+. "${SCRIPT_DIR}/lib/common.sh"
+
+log_info "Running smoke tests for Moko-Cassiopeia repository"
+
+# ----------------------------------------------------------------------------
+# Test: Repository structure
+# ----------------------------------------------------------------------------
+
+log_info "Checking repository structure..."
+
+assert_dir_exists "src"
+assert_file_exists "README.md"
+assert_file_exists "CHANGELOG.md"
+assert_file_exists "LICENSE"
+assert_file_exists "CONTRIBUTING.md"
+
+log_info "✓ Repository structure valid"
+
+# ----------------------------------------------------------------------------
+# Test: Manifest validation
+# ----------------------------------------------------------------------------
+
+log_info "Checking Joomla manifest..."
+
+. "${SCRIPT_DIR}/lib/joomla_manifest.sh"
+
+MANIFEST="$(find_manifest src)"
+log_info "Found manifest: ${MANIFEST}"
+
+VERSION="$(get_manifest_version "${MANIFEST}")"
+NAME="$(get_manifest_name "${MANIFEST}")"
+TYPE="$(get_manifest_type "${MANIFEST}")"
+
+log_info "Extension: ${NAME} (${TYPE}) v${VERSION}"
+
+# Verify manifest is well-formed XML
+require_cmd python3
+python3 - "${MANIFEST}" <<'PY'
+import sys
+import xml.etree.ElementTree as ET
+
+manifest_path = sys.argv[1]
+
+try:
+  tree = ET.parse(manifest_path)
+  root = tree.getroot()
+  if root.tag != "extension":
+    print(f"ERROR: Root element must be <extension>, got <{root.tag}>")
+    sys.exit(1)
+  print("✓ Manifest XML is well-formed")
+except Exception as e:
+  print(f"ERROR: Failed to parse manifest: {e}")
+  sys.exit(1)
+PY
+
+log_info "✓ Manifest validation passed"
+
+# ----------------------------------------------------------------------------
+# Test: Version alignment
+# ----------------------------------------------------------------------------
+
+log_info "Checking version alignment..."
+
+if [ ! -f "CHANGELOG.md" ]; then
+log_warn "CHANGELOG.md not found, skipping version alignment check"
+else
+if grep -q "## \[${VERSION}\]" CHANGELOG.md; then
+log_info "✓ Version ${VERSION} found in CHANGELOG.md"
+else
+log_warn "Version ${VERSION} not found in CHANGELOG.md"
+fi
+fi
+
+# ----------------------------------------------------------------------------
+# Test: Critical files syntax
+# ----------------------------------------------------------------------------
+
+log_info "Checking PHP syntax..."
+
+if command -v php >/dev/null 2>&1; then
+php_errors=0
+while IFS= read -r -d '' f; do
+if ! php -l "$f" >/dev/null 2>&1; then
+log_error "PHP syntax error in: $f"
+php_errors=$((php_errors + 1))
+fi
+done < <(find src -type f -name '*.php' -print0 2>/dev/null)
+
+if [ "${php_errors}" -eq 0 ]; then
+log_info "✓ PHP syntax validation passed"
+else
+die "Found ${php_errors} PHP syntax errors"
+fi
+else
+log_warn "PHP not available, skipping PHP syntax check"
+fi
+
+# ----------------------------------------------------------------------------
+# Summary
+# ----------------------------------------------------------------------------
+
+log_info "========================================="
+log_info "Smoke tests completed successfully"
+log_info "Extension: ${NAME}"
+log_info "Version: ${VERSION}"
+log_info "Type: ${TYPE}"
+log_info "========================================="