From f5cca3487bd7db723cf19220749716374af626c9 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 18:49:25 -0500
Subject: [PATCH 01/21] Search toggle icon on mobile, 2-col desktop; update
 README badges

Search position:
- Desktop: 2 columns (16.667%), menu fills the rest
- Mobile: collapses to a magnifying glass icon button (like the
  hamburger) that expands the search form via Bootstrap collapse

README:
- Version moved to badge (03.09.04)
- Joomla badge updated to 5.x | 6.x
- PHP badge updated to 8.1+
- Removed inline VERSION from title

Remove obsolete build-release.sh and minify.js scripts (replaced
by CI workflow and PHP helper).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 README.md                  |   7 +-
 scripts/build-release.sh   | 132 --------------------------
 scripts/minify.js          | 188 -------------------------------------
 src/index.php              |   5 +-
 src/media/css/template.css |  17 +++-
 5 files changed, 22 insertions(+), 327 deletions(-)
 delete mode 100755 scripts/build-release.sh
 delete mode 100644 scripts/minify.js

diff --git a/README.md b/README.md
index 3bf465f..e26e701 100644
--- a/README.md
+++ b/README.md
@@ -13,13 +13,14 @@
  BRIEF: Documentation for MokoCassiopeia template
  -->
 
-# README - MokoCassiopeia (VERSION: 03.09.03)
+# MokoCassiopeia
 
 **A Modern, Lightweight Joomla Template Based on Cassiopeia**
 
+[![Version](https://img.shields.io/badge/version-03.09.04-green.svg)](https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03)
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
-[![Joomla](https://img.shields.io/badge/Joomla-4.4.x%20%7C%205.x-blue.svg)](https://www.joomla.org)
-[![PHP](https://img.shields.io/badge/PHP-8.0%2B-blue.svg)](https://www.php.net)
+[![Joomla](https://img.shields.io/badge/Joomla-5.x%20%7C%206.x-blue.svg)](https://www.joomla.org)
+[![PHP](https://img.shields.io/badge/PHP-8.1%2B-blue.svg)](https://www.php.net)
 
 MokoCassiopeia is a modern, lightweight enhancement layer built on top of Joomla's Cassiopeia template. It adds **Font Awesome 7**, **Bootstrap 5** helpers, an automatic **Table of Contents (TOC)** utility, advanced **Dark Mode** theming, and optional integrations for **Google Tag Manager** and **Google Analytics (GA4)**—all while maintaining minimal core template overrides for maximum upgrade compatibility.
 
diff --git a/scripts/build-release.sh b/scripts/build-release.sh
deleted file mode 100755
index 5e8055d..0000000
--- a/scripts/build-release.sh
+++ /dev/null
@@ -1,132 +0,0 @@
-#!/usr/bin/env bash
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-# SPDX-License-Identifier: GPL-3.0-or-later
-# 
-# FILE INFORMATION
-# DEFGROUP: Build.Scripts
-# INGROUP: MokoCassiopeia.Build
-# REPO: https://github.com/mokoconsulting-tech/MokoCassiopeia
-# PATH: /scripts/build-release.sh
-# VERSION: 01.00.00
-# BRIEF: Build release package for MokoCassiopeia template
-# USAGE: ./scripts/build-release.sh [version]
-
-set -e
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Script directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
-
-# Functions
-log_info() {
-    echo -e "${BLUE}[INFO]${NC} $1"
-}
-
-log_success() {
-    echo -e "${GREEN}[SUCCESS]${NC} $1"
-}
-
-log_warning() {
-    echo -e "${YELLOW}[WARNING]${NC} $1"
-}
-
-log_error() {
-    echo -e "${RED}[ERROR]${NC} $1"
-}
-
-# Check if version is provided
-if [ -z "$1" ]; then
-    # Try to extract version from templateDetails.xml
-    if [ -f "${PROJECT_ROOT}/src/templateDetails.xml" ]; then
-        VERSION=$(grep -oP '<version>\K[^<]+' "${PROJECT_ROOT}/src/templateDetails.xml" | head -1)
-        log_info "Detected version: ${VERSION}"
-    else
-        log_error "Please provide version as argument: ./build-release.sh 03.08.03"
-        exit 1
-    fi
-else
-    VERSION="$1"
-fi
-
-log_info "Building MokoCassiopeia release package"
-log_info "Version: ${VERSION}"
-
-# Change to project root
-cd "${PROJECT_ROOT}"
-
-# Create build directory
-BUILD_DIR="${PROJECT_ROOT}/build"
-PACKAGE_DIR="${BUILD_DIR}/package"
-rm -rf "${BUILD_DIR}"
-mkdir -p "${PACKAGE_DIR}"
-
-log_info "Creating package structure..."
-
-# Copy template files from src (excluding media directory)
-if [ -d "src" ]; then
-    rsync -av --exclude='.git*' --exclude='media' src/ "${PACKAGE_DIR}/"
-else
-    log_error "src directory not found!"
-    exit 1
-fi
-
-# Copy media files from src/media
-if [ -d "src/media" ]; then
-    mkdir -p "${PACKAGE_DIR}/media"
-    rsync -av --exclude='.git*' src/media/ "${PACKAGE_DIR}/media/"
-else
-    log_warning "src/media directory not found, skipping media files"
-fi
-
-log_info "Package structure created"
-
-# Create ZIP package
-cd "${PACKAGE_DIR}"
-ZIP_NAME="mokocassiopeia-src-${VERSION}.zip"
-log_info "Creating ZIP package: ${ZIP_NAME}"
-
-zip -r "../${ZIP_NAME}" . -q
-
-if [ $? -ne 0 ]; then
-    log_error "Failed to create ZIP package"
-    exit 1
-fi
-
-cd "${BUILD_DIR}"
-log_success "Created: ${ZIP_NAME}"
-
-# Generate checksums
-log_info "Generating checksums..."
-sha256sum "${ZIP_NAME}" > "${ZIP_NAME}.sha256"
-md5sum "${ZIP_NAME}" > "${ZIP_NAME}.md5"
-
-# Extract just the hash
-SHA256_HASH=$(sha256sum "${ZIP_NAME}" | cut -d' ' -f1)
-
-log_success "SHA-256: ${SHA256_HASH}"
-log_success "MD5: $(md5sum "${ZIP_NAME}" | cut -d' ' -f1)"
-
-# Show file info
-FILE_SIZE=$(du -h "${ZIP_NAME}" | cut -f1)
-log_info "Package size: ${FILE_SIZE}"
-
-# Summary
-echo ""
-log_success "Build completed successfully!"
-echo ""
-echo "Package: ${BUILD_DIR}/${ZIP_NAME}"
-echo "SHA-256: ${BUILD_DIR}/${ZIP_NAME}.sha256"
-echo "MD5:     ${BUILD_DIR}/${ZIP_NAME}.md5"
-echo ""
-echo "Next steps:"
-echo "1. Test the package installation in Joomla"
-echo "2. Create a GitHub release with this package"
-echo "3. Update updates.xml with the new version and SHA-256 hash"
-echo ""
diff --git a/scripts/minify.js b/scripts/minify.js
deleted file mode 100644
index b6116e8..0000000
--- a/scripts/minify.js
+++ /dev/null
@@ -1,188 +0,0 @@
-#!/usr/bin/env node
-/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
- *
- * This file is part of a Moko Consulting project.
- *
- * SPDX-License-Identifier: GPL-3.0-or-later
- *
- * # FILE INFORMATION
- * DEFGROUP: Joomla.Template.Site
- * INGROUP: MokoCassiopeia
- * REPO: https://github.com/mokoconsulting-tech/MokoCassiopeia
- * PATH: ./scripts/minify.js
- * VERSION: 03.09.03
- * BRIEF: Generates .min.css and .min.js files from the Joomla asset manifest
- */
-
-'use strict';
-
-const fs   = require('fs');
-const path = require('path');
-
-const CleanCSS = require('clean-css');
-const { minify: terserMinify } = require('terser');
-
-// ---------------------------------------------------------------------------
-// Config
-// ---------------------------------------------------------------------------
-
-const ROOT        = path.resolve(__dirname, '..');
-const SRC_MEDIA   = path.join(ROOT, 'src', 'media');
-const ASSET_JSON  = path.join(ROOT, 'src', 'joomla.asset.json');
-
-// URI prefix used in the manifest — maps to SRC_MEDIA on disk.
-// e.g. "media/templates/site/mokocassiopeia/css/template.css"
-const URI_PREFIX = 'media/templates/site/mokocassiopeia/';
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-/**
- * Resolve a manifest URI to an absolute disk path under src/media/.
- *
- * @param {string} uri  e.g. "media/templates/site/mokocassiopeia/css/foo.css"
- * @returns {string|null}
- */
-function uriToPath(uri) {
-	if (!uri.startsWith(URI_PREFIX)) return null;
-	return path.join(SRC_MEDIA, uri.slice(URI_PREFIX.length));
-}
-
-/**
- * Return true if the filename looks like an already-minified file or belongs
- * to a vendor bundle we don't own.
- */
-function isVendorOrUserFile(filePath) {
-	const rel = filePath.replace(SRC_MEDIA + path.sep, '');
-	return rel.startsWith('vendor' + path.sep)
-		|| path.basename(filePath).startsWith('user.');
-}
-
-// ---------------------------------------------------------------------------
-// Pair detection
-// ---------------------------------------------------------------------------
-
-/**
- * Read the asset manifest and return an array of { src, dest, type } pairs
- * where dest is a minified version of src that doesn't already exist or is
- * older than src.
- *
- * Pairing logic: for every non-.min asset, check whether the manifest also
- * contains a corresponding .min asset. If so, that's our pair.
- */
-function detectPairs(assets) {
-	// Build a lookup of all URIs in the manifest.
-	const uriSet = new Set(assets.map(a => a.uri));
-
-	const pairs = [];
-
-	for (const asset of assets) {
-		const { uri, type } = asset;
-		if (type !== 'style' && type !== 'script') continue;
-
-		// Skip already-minified entries.
-		if (/\.min\.(css|js)$/.test(uri)) continue;
-
-		// Derive the expected .min URI.
-		const minUri = uri.replace(/\.(css|js)$/, '.min.$1');
-		if (!uriSet.has(minUri)) continue;
-
-		const srcPath  = uriToPath(uri);
-		const destPath = uriToPath(minUri);
-		if (!srcPath || !destPath) continue;
-
-		if (isVendorOrUserFile(srcPath)) continue;
-
-		if (!fs.existsSync(srcPath)) {
-			console.warn(`  [skip]  source missing: ${srcPath}`);
-			continue;
-		}
-
-		pairs.push({ src: srcPath, dest: destPath, type });
-	}
-
-	return pairs;
-}
-
-// ---------------------------------------------------------------------------
-// Minifiers
-// ---------------------------------------------------------------------------
-
-async function minifyCSS(srcPath, destPath) {
-	const source  = fs.readFileSync(srcPath, 'utf8');
-	const result  = new CleanCSS({ level: 2, returnPromise: true });
-	const output  = await result.minify(source);
-
-	if (output.errors && output.errors.length) {
-		throw new Error(output.errors.join('\n'));
-	}
-
-	fs.mkdirSync(path.dirname(destPath), { recursive: true });
-	fs.writeFileSync(destPath, output.styles, 'utf8');
-
-	const srcSize  = Buffer.byteLength(source,         'utf8');
-	const destSize = Buffer.byteLength(output.styles,  'utf8');
-	const saving   = (100 - (destSize / srcSize * 100)).toFixed(1);
-
-	return { srcSize, destSize, saving };
-}
-
-async function minifyJS(srcPath, destPath) {
-	const source = fs.readFileSync(srcPath, 'utf8');
-	const result = await terserMinify(source, {
-		compress: { drop_console: false },
-		mangle:   true,
-		format:   { comments: false }
-	});
-
-	if (!result.code) throw new Error('terser returned no output');
-
-	fs.mkdirSync(path.dirname(destPath), { recursive: true });
-	fs.writeFileSync(destPath, result.code, 'utf8');
-
-	const srcSize  = Buffer.byteLength(source,      'utf8');
-	const destSize = Buffer.byteLength(result.code, 'utf8');
-	const saving   = (100 - (destSize / srcSize * 100)).toFixed(1);
-
-	return { srcSize, destSize, saving };
-}
-
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-
-(async () => {
-	const manifest = JSON.parse(fs.readFileSync(ASSET_JSON, 'utf8'));
-	const pairs    = detectPairs(manifest.assets);
-
-	if (pairs.length === 0) {
-		console.log('No pairs found — nothing to minify.');
-		return;
-	}
-
-	console.log(`\nMinifying ${pairs.length} file(s)...\n`);
-
-	let ok = 0, fail = 0;
-
-	for (const { src, dest, type } of pairs) {
-		const label = path.relative(ROOT, src);
-		process.stdout.write(`  ${label} ... `);
-
-		try {
-			const stats = type === 'style'
-				? await minifyCSS(src, dest)
-				: await minifyJS(src, dest);
-
-			const kb = n => (n / 1024).toFixed(1) + ' kB';
-			console.log(`${kb(stats.srcSize)} → ${kb(stats.destSize)}  (${stats.saving}% saved)`);
-			ok++;
-		} catch (err) {
-			console.error(`FAILED\n    ${err.message}`);
-			fail++;
-		}
-	}
-
-	console.log(`\nDone. ${ok} succeeded, ${fail} failed.\n`);
-	if (fail > 0) process.exit(1);
-})();
diff --git a/src/index.php b/src/index.php
index 4fc14e0..5a5abf0 100644
--- a/src/index.php
+++ b/src/index.php
@@ -448,7 +448,10 @@ $wa->useScript('user.js');         // js/user.js
 				</nav>
 			<?php endif; ?>
 			<?php if ($this->countModules('search', true)) : ?>
-				<div class="container-search">
+				<button class="search-toggler d-lg-none" type="button" data-bs-toggle="collapse" data-bs-target="#headerSearchCollapse" aria-controls="headerSearchCollapse" aria-expanded="false" aria-label="<?php echo Text::_('JSEARCH_FILTER_SUBMIT'); ?>">
+					<span class="fa-solid fa-magnifying-glass" aria-hidden="true"></span>
+				</button>
+				<div class="container-search collapse d-lg-block" id="headerSearchCollapse">
 					<jdoc:include type="modules" name="search" style="none" />
 				</div>
 			<?php endif; ?>
diff --git a/src/media/css/template.css b/src/media/css/template.css
index 5b5e9af..d00e024 100644
--- a/src/media/css/template.css
+++ b/src/media/css/template.css
@@ -14477,13 +14477,20 @@ li.current a {
 	min-width: 12rem;
 }
 
-.container-header .navbar-toggler {
+.container-header .navbar-toggler,
+.container-header .search-toggler {
 	color: var(--mainmenu-nav-link-color, #fff);
 	border-color: var(--mainmenu-nav-link-color, #fff);
 	font-size: 1.25rem;
 	cursor: pointer;
 }
 
+.container-header .search-toggler {
+	background: none;
+	border: none;
+	padding: 0.25rem 0.5rem;
+}
+
 .container-header .container-search {
 	margin-top: 0.75em;
 }
@@ -18665,6 +18672,10 @@ nav[data-toggle=toc] .nav-link.active+ul{
 		margin-top: 0.5rem;
 	}
 
+	.container-header .container-search.collapse:not(.show) {
+		display: none;
+	}
+
 	.mod-finder__search.input-group {
 		max-width: 100%;
 	}
@@ -18683,8 +18694,8 @@ nav[data-toggle=toc] .nav-link.active+ul{
 	}
 
 	.container-header .container-search {
-		flex: 0 0 25%;
-		max-width: 25%;
+		flex: 0 0 16.667%;
+		max-width: 16.667%;
 		margin-top: 0;
 	}
 }

From 20fbcabe87e251b9705ad838411b6acc763dfa80 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 18:51:44 -0500
Subject: [PATCH 02/21] docs: update scripts README for current workflow

Remove references to deleted build-release.sh and minify.js.
Document current CI-driven release process and remaining
download-google-fonts.sh script.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 scripts/README.md | 274 ++++++----------------------------------------
 1 file changed, 36 insertions(+), 238 deletions(-)

diff --git a/scripts/README.md b/scripts/README.md
index 0c3f452..995b9dd 100644
--- a/scripts/README.md
+++ b/scripts/README.md
@@ -1,271 +1,69 @@
+<!-- Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+
+ SPDX-License-Identifier: GPL-3.0-or-later
+
+ # FILE INFORMATION
+ DEFGROUP: Joomla.Template.Site
+ INGROUP: MokoCassiopeia.Documentation
+ REPO: https://github.com/mokoconsulting-tech/MokoCassiopeia
+ FILE: scripts/README.md
+ VERSION: 03.09.04
+ BRIEF: Documentation for utility scripts
+ -->
+
 # Scripts — MokoCassiopeia
 
-This directory contains utility scripts for building, releasing, and managing the MokoCassiopeia Joomla template.
+Utility scripts for managing the MokoCassiopeia Joomla template.
 
 ## Available Scripts
 
-### build-release.sh
+### download-google-fonts.sh
 
-**Purpose**: Build a release package for MokoCassiopeia template.
+**Purpose**: Download Google Fonts for local hosting.
 
 **Usage**:
 ```bash
-# Build with auto-detected version from templateDetails.xml
-./scripts/build-release.sh
-
-# Build with specific version
-./scripts/build-release.sh 03.08.03
+./scripts/download-google-fonts.sh
 ```
 
-**What it does**:
-1. Creates a `build/` directory
-2. Copies template files from `src/`
-3. Copies media files from `src/media/` to `media/`
-4. Creates a ZIP package: `mokocassiopeia-src-{version}.zip`
-5. Generates SHA-256 and MD5 checksums
-6. Outputs package location and checksums
-
-**Output**:
-- `build/mokocassiopeia-src-{version}.zip` - Installation package
-- `build/mokocassiopeia-src-{version}.zip.sha256` - SHA-256 checksum
-- `build/mokocassiopeia-src-{version}.zip.md5` - MD5 checksum
-
-**Requirements**:
-- `rsync` for file copying
-- `zip` for package creation
-- `sha256sum` and `md5sum` for checksums
+Downloads font files and generates CSS `@font-face` declarations for local serving, avoiding external CDN dependencies.
 
 ---
 
-## Automated Workflows
+## Build & Release
 
-The repository includes GitHub Actions workflows that automate the build and release process:
+Builds and releases are handled entirely by GitHub Actions workflows. There are no local build scripts.
 
-### `.github/workflows/release.yml`
+### auto-release.yml
 
-**Purpose**: Automated release creation when tags are pushed.
-
-**Triggers**:
-- Push of version tag (e.g., `03.08.03`)
-- Manual workflow dispatch with version input
+**Triggers**: Push to `version/*` branches, manual dispatch.
 
 **Process**:
-1. Checks out repository
-2. Sets up PHP environment
-3. Installs dependencies (if composer.json exists)
-4. Updates version numbers in manifest files
-5. Creates package structure
-6. Builds ZIP package
-7. Generates checksums
-8. Creates GitHub Release with artifacts
+1. Reads version from `templateDetails.xml`
+2. Builds ZIP from `src/` contents
+3. Computes SHA-256 checksum
+4. Creates/updates GitHub Release with ZIP asset
+5. Updates `update.xml` with download URL and checksum
 
-**Usage**:
-```bash
-# Create and push a tag
-git tag 03.08.04
-git push origin 03.08.04
+### update-server.yml
 
-# Or use GitHub UI to run manually
-```
-
----
-
-### `.github/workflows/auto-update-sha.yml`
-
-**Purpose**: Automatically update SHA-256 hash in `updates.xml` after a release is published.
-
-**Triggers**:
-- GitHub Release published
-- Manual workflow dispatch with tag input
+**Triggers**: Release published, manual dispatch.
 
 **Process**:
-1. Downloads the release package
-2. Calculates SHA-256 hash
-3. Updates `updates.xml` with:
-   - New version number
-   - Current date
-   - Download URL
-   - SHA-256 hash
-4. Commits and pushes changes to main branch
-
-**Benefits**:
-- Ensures `updates.xml` always has correct SHA-256 hash
-- Enables Joomla update server functionality
-- Reduces manual update errors
-- Automates security verification
+1. Updates `updates.xml` with version, download URL, and SHA-256
+2. Commits changes to main
 
 ---
 
 ## Release Process
 
-### Manual Release (Local Build)
+All releases are automated via CI. To release:
 
-1. **Update version numbers**:
-   ```bash
-   # Update these files manually:
-   # - src/templateDetails.xml
-   # - updates.xml
-   # - CHANGELOG.md
-   ```
+1. Bump version in `src/templateDetails.xml`
+2. Merge to main
+3. The workflow detects the version, builds the ZIP, and creates the release
 
-2. **Build package**:
-   ```bash
-   ./scripts/build-release.sh 03.08.04
-   ```
-
-3. **Test package**:
-   - Install ZIP in Joomla test environment
-   - Verify all features work correctly
-
-4. **Create GitHub Release**:
-   - Go to GitHub Releases
-   - Click "Create a new release"
-   - Upload the ZIP, SHA256, and MD5 files
-   - Add release notes from CHANGELOG.md
-
-5. **Update updates.xml**:
-   - Copy SHA-256 hash from `.sha256` file
-   - Update `updates.xml` with new hash
-   - Commit and push changes
-
----
-
-### Automated Release (GitHub Actions)
-
-1. **Update version numbers**:
-   ```bash
-   # Update these files in a branch:
-   # - src/templateDetails.xml
-   # - CHANGELOG.md
-   
-   git checkout -b release/03.08.04
-   # Make changes
-   git commit -m "chore: Prepare release 03.08.04"
-   git push origin release/03.08.04
-   ```
-
-2. **Create and merge PR**:
-   - Create PR from release branch
-   - Review changes
-   - Merge to main
-
-3. **Create and push tag**:
-   ```bash
-   git checkout main
-   git pull
-   git tag 03.08.04
-   git push origin 03.08.04
-   ```
-
-4. **Automated process**:
-   - GitHub Actions builds package automatically
-   - Creates GitHub Release with artifacts
-   - `auto-update-sha` workflow updates `updates.xml`
-
-5. **Verify**:
-   - Check GitHub Release is created
-   - Verify `updates.xml` has correct SHA-256
-   - Test Joomla update server
-
----
-
-## Development Workflow
-
-### Testing Local Builds
-
-```bash
-# Build current version
-./scripts/build-release.sh
-
-# Install in Joomla
-# Navigate to Extensions > Manage > Install > Upload Package File
-# Select: build/mokocassiopeia-src-{version}.zip
-```
-
-### Pre-Release Checklist
-
-- [ ] All code changes merged to main
-- [ ] Version numbers updated:
-  - [ ] `src/templateDetails.xml`
-  - [ ] `CHANGELOG.md`
-- [ ] CHANGELOG.md updated with release notes
-- [ ] Tests passing
-- [ ] Documentation updated
-- [ ] Local build tested in Joomla
-
----
-
-## Troubleshooting
-
-### Build Fails
-
-**Problem**: `rsync: command not found`
-```bash
-# Ubuntu/Debian
-sudo apt-get install rsync
-
-# macOS
-brew install rsync
-```
-
-**Problem**: `zip: command not found`
-```bash
-# Ubuntu/Debian
-sudo apt-get install zip
-
-# macOS (usually pre-installed)
-brew install zip
-```
-
-### GitHub Actions Fails
-
-**Problem**: Release workflow fails on tag push
-
-Check:
-1. Tag format matches pattern: `[0-9][0-9].[0-9][0-9].[0-9][0-9]`
-2. Repository has write permissions for GITHUB_TOKEN
-3. `src/` and `src/media/` directories exist
-
-**Problem**: auto-update-sha fails
-
-Check:
-1. Release package was published successfully
-2. Workflow has write permissions
-3. Package naming matches expected format
-
----
-
-## File Structure
-
-```
-scripts/
-├── README.md              # This file
-└── build-release.sh       # Local build script
-
-.github/workflows/
-├── release.yml            # Automated release workflow
-└── auto-update-sha.yml    # SHA hash update workflow
-```
-
----
-
-## Contributing
-
-When adding new scripts:
-
-1. Add GPL-3.0-or-later license header
-2. Include FILE INFORMATION block
-3. Add usage documentation in this README
-4. Make scripts executable: `chmod +x scripts/your-script.sh`
-5. Test thoroughly before committing
-
----
-
-## Support
-
-- **Issues**: [GitHub Issues](https://github.com/mokoconsulting-tech/MokoCassiopeia/issues)
-- **Email**: hello@mokoconsulting.tech
-- **Documentation**: [docs/](../docs/)
+**Only create releases when `src/` has changes.** Non-src changes (docs, workflows, scripts) are cleanup and do not require a release.
 
 ---
 

From edd4806b2d90e31c51b9c24d3a86b5b58a3dc6ce Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 18:55:23 -0500
Subject: [PATCH 03/21] Point update.xml to rc release for testing

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 update.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/update.xml b/update.xml
index 4370317..56bc38e 100644
--- a/update.xml
+++ b/update.xml
@@ -10,11 +10,11 @@
     <tags>
       <tag>stable</tag>
     </tags>
-    <infourl title="MokoCassiopeia">https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03</infourl>
+    <infourl title="MokoCassiopeia">https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03.09.04-rc</infourl>
     <downloads>
-      <downloadurl type="full" format="zip">https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.09.04.zip</downloadurl>
+      <downloadurl type="full" format="zip">https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-rc/mokocassiopeia-03.09.04-rc.zip</downloadurl>
     </downloads>
-    <sha256>da85bf5a34cafadbae26df199ed36c04438e7dab440d046e0e4117d25510feaf</sha256>
+    <sha256>24ab00f1a3931c9b5372e9ecd58205648420da196a53c7e7f45cca615dd53864</sha256>
     <targetplatform name="joomla" version="(5|6)\..*" />
     <maintainer>Moko Consulting</maintainer>
     <maintainerurl>https://mokoconsulting.tech</maintainerurl>

From 96b64af83fc7cc55938e835e4d1ab265a5b8bd95 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 18:58:00 -0500
Subject: [PATCH 04/21] ci: sync AI instructions from main

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .github/CLAUDE.md                  | 378 ++++++++++++++++-------------
 .github/copilot-instructions.md    |  21 +-
 .github/workflows/auto-release.yml |   3 +
 3 files changed, 227 insertions(+), 175 deletions(-)

diff --git a/.github/CLAUDE.md b/.github/CLAUDE.md
index 45f7606..e991394 100644
--- a/.github/CLAUDE.md
+++ b/.github/CLAUDE.md
@@ -1,3 +1,22 @@
+<!--
+Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+
+This file is part of a Moko Consulting project.
+
+SPDX-License-Identifier: GPL-3.0-or-later
+
+# FILE INFORMATION
+DEFGROUP: MokoStandards.Templates.GitHub
+INGROUP: MokoStandards.Templates
+REPO: https://github.com/mokoconsulting-tech/MokoStandards
+PATH: /templates/github/copilot-instructions.joomla.md.template
+VERSION: XX.YY.ZZ
+BRIEF: GitHub Copilot custom instructions template for Joomla/MokoWaaS governed repositories
+NOTE: Synced to .github/copilot-instructions.md in all Joomla/WaaS repos via bulk sync.
+      Tokens replaced at sync time: MokoCassiopeia, https://github.com/mokoconsulting-tech/MokoCassiopeia, {{EXTENSION_NAME}},
+      {{EXTENSION_TYPE}}, {{EXTENSION_ELEMENT}}
+-->
+
 > [!IMPORTANT]
 > **🔧 AI Self-Update Required on First Use**
 >
@@ -19,135 +38,34 @@
 > |---|---|
 > | `MokoCassiopeia` | The GitHub repository name (visible in the URL, `README.md` heading, or `git remote -v`) |
 > | `https://github.com/mokoconsulting-tech/MokoCassiopeia` | Full GitHub URL, e.g. `https://github.com/mokoconsulting-tech/<repo-name>` |
-> | `A modern enhancement layer for Joomla’s Cassiopeia template. Moko-Cassiopeia adds Font Awesome 7, Bootstrap 5 helpers, an automatic Table of Contents (TOC) utility, and optional expansions including Google Tag Manager and Google Analytics (GA4) hooks.` | First paragraph of `README.md` body, or the GitHub repo description |
 > | `{{EXTENSION_NAME}}` | The `<name>` element in `manifest.xml` at the repository root |
 > | `{{EXTENSION_TYPE}}` | The `type` attribute of the `<extension>` tag in `manifest.xml` (`component`, `module`, `plugin`, or `template`) |
 > | `{{EXTENSION_ELEMENT}}` | The `<element>` tag in `manifest.xml`, or the filename prefix (e.g. `com_myextension`, `mod_mymodule`) |
 >
 > ---
 
-# What This Repo Is
+# MokoCassiopeia — GitHub Copilot Custom Instructions
 
-**MokoCassiopeia** is a Moko Consulting **MokoWaaS** (Joomla) extension repository.
+## What This Repo Is
 
-A modern enhancement layer for Joomla’s Cassiopeia template. Moko-Cassiopeia adds Font Awesome 7, Bootstrap 5 helpers, an automatic Table of Contents (TOC) utility, and optional expansions including Google Tag Manager and Google Analytics (GA4) hooks.
+This is a **Moko Consulting MokoWaaS** (Joomla) repository governed by [MokoStandards](https://github.com/mokoconsulting-tech/MokoStandards). All coding standards, workflows, and policies are defined there and enforced here via bulk sync.
 
+Repository URL: https://github.com/mokoconsulting-tech/MokoCassiopeia
 Extension name: **{{EXTENSION_NAME}}**
 Extension type: **{{EXTENSION_TYPE}}** (`{{EXTENSION_ELEMENT}}`)
-Repository URL: https://github.com/mokoconsulting-tech/MokoCassiopeia
-
-This repository is governed by [MokoStandards](https://github.com/mokoconsulting-tech/MokoStandards) — the single source of truth for coding standards, file-header policies, GitHub Actions workflows, and Terraform configuration templates across all Moko Consulting repositories.
+Platform: **Joomla 4.x / MokoWaaS**
 
 ---
 
-# Repo Structure
+## Primary Language
 
-```
-MokoCassiopeia/
-├── manifest.xml          # Joomla installer manifest (root — required)
-├── update.xml            # Update server manifest (root — required)
-├── site/                 # Frontend (site) code
-│   ├── controller.php
-│   ├── controllers/
-│   ├── models/
-│   └── views/
-├── admin/                # Backend (admin) code
-│   ├── controller.php
-│   ├── controllers/
-│   ├── models/
-│   ├── views/
-│   └── sql/
-├── language/             # Language INI files
-├── media/                # CSS, JS, images
-├── docs/                 # Technical documentation
-├── tests/                # Test suite
-├── .github/
-│   ├── workflows/        # CI/CD workflows (synced from MokoStandards)
-│   ├── copilot-instructions.md
-│   └── CLAUDE.md         # This file
-├── README.md             # Version source of truth
-├── CHANGELOG.md
-├── CONTRIBUTING.md
-└── LICENSE               # GPL-3.0-or-later
-```
+**PHP** (≥ 7.4) is the primary language for this Joomla extension. JavaScript may be used for frontend enhancements. YAML uses 2-space indentation. All other text files use tabs per `.editorconfig`.
 
 ---
 
-# Primary Language
+## File Header — Always Required on New Files
 
-**PHP** (≥ 7.4) is the primary language for this Joomla extension. YAML uses 2-space indentation. All other text files use tabs per `.editorconfig`.
-
----
-
-# Version Management
-
-**`README.md` is the single source of truth for the repository version.**
-
-- **Bump the patch version on every PR** — increment `XX.YY.ZZ` (e.g. `01.02.03` → `01.02.04`) in `README.md` before opening the PR; the `sync-version-on-merge` workflow propagates it to all `FILE INFORMATION` headers automatically on merge.
-- Version format is zero-padded semver: `XX.YY.ZZ` (e.g. `01.02.03`).
-- Never hardcode a version number in body text — use the badge or FILE INFORMATION header only.
-
-### Joomla Version Alignment
-
-Three files must **always have the same version**:
-
-| File | Where the version lives |
-|------|------------------------|
-| `README.md` | `FILE INFORMATION` block + badge |
-| `manifest.xml` | `<version>` tag |
-| `update.xml` | `<version>` in the most recent `<update>` block |
-
-The `make release` command / release workflow syncs all three automatically.
-
----
-
-# update.xml — Required in Repo Root
-
-`update.xml` is the Joomla update server manifest. It allows Joomla installations to check for new versions of this extension via:
-
-```xml
-<!-- In manifest.xml -->
-<updateservers>
-	<server type="extension" priority="1" name="{{EXTENSION_NAME}}">
-		https://github.com/mokoconsulting-tech/MokoCassiopeia/raw/main/update.xml
-	</server>
-</updateservers>
-```
-
-**Rules:**
-- Every release prepends a new `<update>` block at the top — older entries are preserved.
-- `<version>` in `update.xml` must exactly match `<version>` in `manifest.xml` and `README.md`.
-- `<downloadurl>` must be a publicly accessible GitHub Releases asset URL.
-- `<targetplatform version="4\.[0-9]+">` — backslash is literal (Joomla regex syntax).
-
-Example `update.xml` entry for a new release:
-```xml
-<updates>
-	<update>
-		<name>{{EXTENSION_NAME}}</name>
-		<description>MokoCassiopeia</description>
-		<element>{{EXTENSION_ELEMENT}}</element>
-		<type>{{EXTENSION_TYPE}}</type>
-		<version>01.02.04</version>
-		<infourl title="Release Information">https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/01.02.04</infourl>
-		<downloads>
-			<downloadurl type="full" format="zip">
-				https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/01.02.04/{{EXTENSION_ELEMENT}}-01.02.04.zip
-			</downloadurl>
-		</downloads>
-		<targetplatform name="joomla" version="4\.[0-9]+" />
-		<php_minimum>7.4</php_minimum>
-		<maintainer>Moko Consulting</maintainer>
-		<maintainerurl>https://mokoconsulting.tech</maintainerurl>
-	</update>
-</updates>
-```
-
----
-
-# File Header Requirements
-
-Every new file **must** have a copyright header as its first content. JSON files, binary files, generated files, and third-party files are exempt.
+Every new file needs a copyright header as its first content.
 
 **PHP:**
 ```php
@@ -162,47 +80,141 @@ Every new file **must** have a copyright header as its first content. JSON files
  * DEFGROUP: MokoCassiopeia.{{EXTENSION_TYPE}}
  * INGROUP: MokoCassiopeia
  * REPO: https://github.com/mokoconsulting-tech/MokoCassiopeia
- * PATH: /site/controllers/item.php
+ * PATH: /path/to/file.php
  * VERSION: XX.YY.ZZ
- * BRIEF: One-line description of file purpose
+ * BRIEF: One-line description of purpose
  */
 
 defined('_JEXEC') or die;
 ```
 
-**Markdown / YAML / Shell / XML:** Use the appropriate comment syntax with the same fields.
+**Markdown:**
+```markdown
+<!--
+Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+
+This file is part of a Moko Consulting project.
+
+SPDX-License-Identifier: GPL-3.0-or-later
+
+# FILE INFORMATION
+DEFGROUP: MokoCassiopeia.Documentation
+INGROUP: MokoCassiopeia
+REPO: https://github.com/mokoconsulting-tech/MokoCassiopeia
+PATH: /docs/file.md
+VERSION: XX.YY.ZZ
+BRIEF: One-line description
+-->
+```
+
+**YAML / Shell / XML:** Use the appropriate comment syntax with the same fields. JSON files are exempt.
 
 ---
 
-# Coding Standards
+## Version Management
 
-## Naming Conventions
+**`README.md` is the single source of truth for the repository version.**
 
-| Context | Convention | Example |
-|---------|-----------|---------|
-| PHP class | `PascalCase` | `ItemModel` |
-| PHP method / function | `camelCase` | `getItems()` |
-| PHP variable | `$snake_case` | `$item_id` |
-| PHP constant | `UPPER_SNAKE_CASE` | `MAX_ITEMS` |
-| PHP class file | `PascalCase.php` | `ItemModel.php` |
-| YAML workflow | `kebab-case.yml` | `ci-joomla.yml` |
-| Markdown doc | `kebab-case.md` | `installation-guide.md` |
+- **Bump the patch version on every PR** — increment `XX.YY.ZZ` (e.g. `01.02.03` → `01.02.04`) in `README.md` before opening the PR; the `sync-version-on-merge` workflow propagates it automatically to all badges and `FILE INFORMATION` headers on merge to `main`.
+- The `VERSION: XX.YY.ZZ` field in `README.md` governs all other version references.
+- Version format is zero-padded semver: `XX.YY.ZZ` (e.g. `01.02.03`).
+- Never hardcode a specific version in document body text — use the badge or FILE INFORMATION header only.
 
-## Commit Messages
+### Joomla Version Alignment
 
-Format: `<type>(<scope>): <subject>` — imperative, lower-case subject, no trailing period.
+The version in `README.md` **must always match** the `<version>` tag in `manifest.xml` and the latest entry in `update.xml`. The `make release` command / release workflow updates all three automatically.
 
-Valid types: `feat` · `fix` · `docs` · `chore` · `ci` · `refactor` · `style` · `test` · `perf` · `revert` · `build`
+```xml
+<!-- In manifest.xml — must match README.md version -->
+<version>01.02.04</version>
 
-## Branch Naming
-
-Format: `<prefix>/<MAJOR.MINOR.PATCH>[/description]`
-
-Approved prefixes: `dev/` · `rc/` · `version/` · `patch/` · `copilot/` · `dependabot/`
+<!-- In update.xml — prepend a new <update> block for every release.
+     Note: the backslash in version="4\.[0-9]+" is a literal backslash character
+     in the XML attribute value. Joomla's update server treats the value as a
+     regular expression, so \. matches a literal dot. -->
+<updates>
+	<update>
+		<name>{{EXTENSION_NAME}}</name>
+		<version>01.02.04</version>
+		<downloads>
+			<downloadurl type="full" format="zip">
+				https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/01.02.04/{{EXTENSION_ELEMENT}}-01.02.04.zip
+			</downloadurl>
+		</downloads>
+		<targetplatform name="joomla" version="4\.[0-9]+" />
+	</update>
+	<!-- … older entries preserved below … -->
+</updates>
+```
 
 ---
 
-# GitHub Actions — Token Usage
+## Joomla Extension Structure
+
+```
+MokoCassiopeia/
+├── manifest.xml          # Joomla installer manifest (root — required)
+├── update.xml            # Update server manifest (root — required, see below)
+├── site/                 # Frontend (site) code
+│   ├── controller.php
+│   ├── controllers/
+│   ├── models/
+│   └── views/
+├── admin/                # Backend (admin) code
+│   ├── controller.php
+│   ├── controllers/
+│   ├── models/
+│   ├── views/
+│   └── sql/
+├── language/             # Language INI files
+├── media/                # CSS, JS, images (deployed to /media/{{EXTENSION_ELEMENT}}/)
+├── docs/                 # Technical documentation
+├── tests/                # Test suite
+├── .github/
+│   ├── workflows/
+│   ├── copilot-instructions.md  # This file
+│   └── CLAUDE.md
+├── README.md             # Version source of truth
+├── CHANGELOG.md
+├── CONTRIBUTING.md
+├── LICENSE               # GPL-3.0-or-later
+└── Makefile              # Build automation
+```
+
+---
+
+## update.xml — Required in Repo Root
+
+`update.xml` **must exist at the repository root**. It is the Joomla update server manifest that allows Joomla installations to check for new versions of this extension.
+
+The `manifest.xml` must reference it via:
+```xml
+<updateservers>
+	<server type="extension" priority="1" name="{{EXTENSION_NAME}}">
+		https://github.com/mokoconsulting-tech/MokoCassiopeia/raw/main/update.xml
+	</server>
+</updateservers>
+```
+
+**Rules:**
+- Every release must prepend a new `<update>` block at the top of `update.xml` — old entries must be preserved below.
+- The `<version>` in `update.xml` must exactly match `<version>` in `manifest.xml` and the version in `README.md`.
+- The `<downloadurl>` must be a publicly accessible direct download link (GitHub Releases asset URL).
+- `<targetplatform name="joomla" version="4\.[0-9]+">` — the backslash is a **literal backslash character** in the XML attribute value; Joomla's update-server parser treats the value as a regular expression, so `\.` matches a literal dot and `[0-9]+` matches one or more digits. Do not double-escape it.
+
+---
+
+## manifest.xml Rules
+
+- Lives at the repo root as `manifest.xml` (not inside `site/` or `admin/`).
+- `<version>` tag must be kept in sync with `README.md` version and `update.xml`.
+- Must include `<updateservers>` block pointing to this repo's `update.xml`.
+- Must include `<files folder="site">` and `<administration>` sections.
+- Joomla 4.x requires `<namespace path="src">Moko\{{EXTENSION_NAME}}</namespace>` for namespaced extensions.
+
+---
+
+## GitHub Actions — Token Usage
 
 Every workflow must use **`secrets.GH_TOKEN`** (the org-level Personal Access Token).
 
@@ -217,58 +229,76 @@ env:
 ```
 
 ```yaml
-# ❌ Wrong — never use these
+# ❌ Wrong — never use these in workflows
 token: ${{ github.token }}
 token: ${{ secrets.GITHUB_TOKEN }}
 ```
 
 ---
 
-# Keeping Documentation Current
+## MokoStandards Reference
 
-| Change type | Documentation to update |
-|-------------|------------------------|
-| New or renamed PHP class/method | PHPDoc block; `docs/api/` entry |
-| New or changed `manifest.xml` | Sync version to `update.xml` and `README.md` |
-| New release | Prepend `<update>` to `update.xml`; update `CHANGELOG.md`; bump `README.md` |
-| New or changed workflow | `docs/workflows/<workflow-name>.md` |
-| Any modified file | Update the `VERSION` field in that file's `FILE INFORMATION` block |
-| **Every PR** | **Bump the patch version** — increment `XX.YY.ZZ` in `README.md`; `sync-version-on-merge` propagates it |
-
----
-
-# What NOT to Do
-
-- **Never commit directly to `main`** — all changes go through a PR.
-- **Never hardcode version numbers** in body text — update `README.md` and let automation propagate.
-- **Never let `manifest.xml`, `update.xml`, and `README.md` versions diverge.**
-- **Never skip the FILE INFORMATION block** on a new source file.
-- **Never use bare `catch (\Throwable $e) {}`** — always log or re-throw.
-- **Never mix tabs and spaces** within a file — follow `.editorconfig`.
-- **Never use `github.token` or `secrets.GITHUB_TOKEN` in workflows** — always use `secrets.GH_TOKEN`.
-- **Never remove `defined('_JEXEC') or die;`** from web-accessible PHP files.
-
----
-
-# PR Checklist
-
-Before opening a PR, verify:
-
-- [ ] Patch version bumped in `README.md` (e.g. `01.02.03` → `01.02.04`)
-- [ ] If this is a release: `manifest.xml` version updated; `update.xml` updated with new entry
-- [ ] FILE INFORMATION headers updated in modified files
-- [ ] CHANGELOG.md updated
-- [ ] Tests pass
-
----
-
-# Key Policy Documents (MokoStandards)
+This repository is governed by [MokoStandards](https://github.com/mokoconsulting-tech/MokoStandards). Authoritative policies:
 
 | Document | Purpose |
 |----------|---------|
 | [file-header-standards.md](https://github.com/mokoconsulting-tech/MokoStandards/blob/main/docs/policy/file-header-standards.md) | Copyright-header rules for every file type |
 | [coding-style-guide.md](https://github.com/mokoconsulting-tech/MokoStandards/blob/main/docs/policy/coding-style-guide.md) | Naming and formatting conventions |
 | [branching-strategy.md](https://github.com/mokoconsulting-tech/MokoStandards/blob/main/docs/policy/branching-strategy.md) | Branch naming, hierarchy, and release workflow |
-| [merge-strategy.md](https://github.com/mokoconsulting-tech/MokoStandards/blob/main/docs/policy/merge-strategy.md) | Squash-merge policy and PR conventions |
+| [merge-strategy.md](https://github.com/mokoconsulting-tech/MokoStandards/blob/main/docs/policy/merge-strategy.md) | Squash-merge policy and PR title/body conventions |
 | [changelog-standards.md](https://github.com/mokoconsulting-tech/MokoStandards/blob/main/docs/policy/changelog-standards.md) | How and when to update CHANGELOG.md |
-| [joomla-development-guide.md](https://github.com/mokoconsulting-tech/MokoStandards/blob/main/docs/guide/waas/joomla-development-guide.md) | MokoWaaS Joomla extension development guide |
\ No newline at end of file
+| [joomla-development-guide.md](https://github.com/mokoconsulting-tech/MokoStandards/blob/main/docs/guide/waas/joomla-development-guide.md) | MokoWaaS Joomla extension development guide |
+
+---
+
+## Naming Conventions
+
+| Context | Convention | Example |
+|---------|-----------|---------|
+| PHP class | `PascalCase` | `MyController` |
+| PHP method / function | `camelCase` | `getItems()` |
+| PHP variable | `$snake_case` | `$item_id` |
+| PHP constant | `UPPER_SNAKE_CASE` | `MAX_ITEMS` |
+| PHP class file | `PascalCase.php` | `ItemModel.php` |
+| YAML workflow | `kebab-case.yml` | `ci-joomla.yml` |
+| Markdown doc | `kebab-case.md` | `installation-guide.md` |
+
+---
+
+## Commit Messages
+
+Format: `<type>(<scope>): <subject>` — imperative, lower-case subject, no trailing period.
+
+Valid types: `feat` · `fix` · `docs` · `chore` · `ci` · `refactor` · `style` · `test` · `perf` · `revert` · `build`
+
+---
+
+## Branch Naming
+
+Format: `<prefix>/<MAJOR.MINOR.PATCH>[/description]`
+
+Approved prefixes: `dev/` · `rc/` · `version/` · `patch/` · `copilot/` · `dependabot/`
+
+---
+
+## Keeping Documentation Current
+
+| Change type | Documentation to update |
+|-------------|------------------------|
+| New or renamed PHP class/method | PHPDoc block; `docs/api/` entry |
+| New or changed manifest.xml | Update `update.xml` version; bump README.md version |
+| New release | Prepend `<update>` block to `update.xml`; update CHANGELOG.md; bump README.md version |
+| New or changed workflow | `docs/workflows/<workflow-name>.md` |
+| Any modified file | Update the `VERSION` field in that file's `FILE INFORMATION` block |
+| **Every PR** | **Bump the patch version** — increment `XX.YY.ZZ` in `README.md`; `sync-version-on-merge` propagates it |
+
+---
+
+## Key Constraints
+
+- Never commit directly to `main` — all changes go via PR, squash-merged
+- Never skip the FILE INFORMATION block on a new file
+- Never add `defined('_JEXEC') or die;` to CLI scripts or model tests — only to web-accessible PHP files
+- Never hardcode version numbers in body text — update `README.md` and let automation propagate
+- Never use `github.token` or `secrets.GITHUB_TOKEN` in workflows — always use `secrets.GH_TOKEN`
+- Never let `manifest.xml` version, `update.xml` version, and `README.md` version go out of sync
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index 3968dc4..e991394 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -1,3 +1,22 @@
+<!--
+Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+
+This file is part of a Moko Consulting project.
+
+SPDX-License-Identifier: GPL-3.0-or-later
+
+# FILE INFORMATION
+DEFGROUP: MokoStandards.Templates.GitHub
+INGROUP: MokoStandards.Templates
+REPO: https://github.com/mokoconsulting-tech/MokoStandards
+PATH: /templates/github/copilot-instructions.joomla.md.template
+VERSION: XX.YY.ZZ
+BRIEF: GitHub Copilot custom instructions template for Joomla/MokoWaaS governed repositories
+NOTE: Synced to .github/copilot-instructions.md in all Joomla/WaaS repos via bulk sync.
+      Tokens replaced at sync time: MokoCassiopeia, https://github.com/mokoconsulting-tech/MokoCassiopeia, {{EXTENSION_NAME}},
+      {{EXTENSION_TYPE}}, {{EXTENSION_ELEMENT}}
+-->
+
 > [!IMPORTANT]
 > **🔧 AI Self-Update Required on First Use**
 >
@@ -282,4 +301,4 @@ Approved prefixes: `dev/` · `rc/` · `version/` · `patch/` · `copilot/` · `d
 - Never add `defined('_JEXEC') or die;` to CLI scripts or model tests — only to web-accessible PHP files
 - Never hardcode version numbers in body text — update `README.md` and let automation propagate
 - Never use `github.token` or `secrets.GITHUB_TOKEN` in workflows — always use `secrets.GH_TOKEN`
-- Never let `manifest.xml` version, `update.xml` version, and `README.md` version go out of sync
\ No newline at end of file
+- Never let `manifest.xml` version, `update.xml` version, and `README.md` version go out of sync
diff --git a/.github/workflows/auto-release.yml b/.github/workflows/auto-release.yml
index e9c2570..528d4cb 100644
--- a/.github/workflows/auto-release.yml
+++ b/.github/workflows/auto-release.yml
@@ -39,6 +39,9 @@ on:
     branches:
       - main
       - master
+    paths:
+      - 'src/**'
+      - 'htdocs/**'
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true

From 61042bc529fda321d7e0a86f970211305f324fea Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 18:58:24 -0500
Subject: [PATCH 05/21] Test RC bump: 03.09.05 pointing to rc release

Bump version to 03.09.05, update both update.xml and updates.xml
to point to the v03.09.04-rc release with new ZIP asset.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/templateDetails.xml |  2 +-
 update.xml              |  6 +++---
 updates.xml             | 10 +++++-----
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/templateDetails.xml b/src/templateDetails.xml
index 64e3aac..fe396eb 100644
--- a/src/templateDetails.xml
+++ b/src/templateDetails.xml
@@ -36,7 +36,7 @@
 	  </server>
 	</updateservers>
 	<name>MokoCassiopeia</name>
-	<version>03.09.04</version>
+	<version>03.09.05</version>
 	<scriptfile>script.php</scriptfile>
 	<creationDate>2026-03-26</creationDate>
 	<author>Jonathan Miller || Moko Consulting</author>
diff --git a/update.xml b/update.xml
index 56bc38e..fd33361 100644
--- a/update.xml
+++ b/update.xml
@@ -5,16 +5,16 @@
     <description>Moko Consulting site template based on Cassiopeia.</description>
     <element>mokocassiopeia</element>
     <type>template</type>
-    <version>03.09.04</version>
+    <version>03.09.05</version>
     <client>site</client>
     <tags>
       <tag>stable</tag>
     </tags>
     <infourl title="MokoCassiopeia">https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03.09.04-rc</infourl>
     <downloads>
-      <downloadurl type="full" format="zip">https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-rc/mokocassiopeia-03.09.04-rc.zip</downloadurl>
+      <downloadurl type="full" format="zip">https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-rc/mokocassiopeia-03.09.05-rc.zip</downloadurl>
     </downloads>
-    <sha256>24ab00f1a3931c9b5372e9ecd58205648420da196a53c7e7f45cca615dd53864</sha256>
+    <sha256>fa0cd74ba37ede0dbb98256feca9a1f6f70b917b8487b778118de3d18b32074b</sha256>
     <targetplatform name="joomla" version="(5|6)\..*" />
     <maintainer>Moko Consulting</maintainer>
     <maintainerurl>https://mokoconsulting.tech</maintainerurl>
diff --git a/updates.xml b/updates.xml
index 723cc4a..f485481 100644
--- a/updates.xml
+++ b/updates.xml
@@ -10,7 +10,7 @@
  INGROUP: MokoCassiopeia
  REPO: https://github.com/mokoconsulting-tech/MokoCassiopeia
  PATH: ./updates.xml
- VERSION: 03.09.04
+ VERSION: 03.09.05
  BRIEF: Update manifest XML file for MokoCassiopeia
  -->
 
@@ -22,18 +22,18 @@
     <type>template</type>
     <client>site</client>
 
-    <version>03.09.04</version>
+    <version>03.09.05</version>
     <creationDate>2026-04-07</creationDate>
     <author>Jonathan Miller || Moko Consulting</author>
     <authorEmail>hello@mokoconsulting.tech</authorEmail>
     <copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
 
-    <infourl title='MokoCassiopeia'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03</infourl>
+    <infourl title='MokoCassiopeia'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03.09.04-rc</infourl>
 
     <downloads>
-      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.09.04.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-rc/mokocassiopeia-03.09.05-rc.zip</downloadurl>
     </downloads>
-    <sha256>da85bf5a34cafadbae26df199ed36c04438e7dab440d046e0e4117d25510feaf</sha256>
+    <sha256>fa0cd74ba37ede0dbb98256feca9a1f6f70b917b8487b778118de3d18b32074b</sha256>
 
     <tags>
       <tag>stable</tag>

From 3533dcc7ef03de0bb8760230205dc80e22388348 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:00:01 -0500
Subject: [PATCH 06/21] =?UTF-8?q?Remove=20update.xml=20=E2=80=94=20updates?=
 =?UTF-8?q?.xml=20is=20the=20canonical=20manifest?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

templateDetails.xml references updates.xml. The duplicate
update.xml is not used and causes confusion.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 update.xml | 22 ----------------------
 1 file changed, 22 deletions(-)
 delete mode 100644 update.xml

diff --git a/update.xml b/update.xml
deleted file mode 100644
index fd33361..0000000
--- a/update.xml
+++ /dev/null
@@ -1,22 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<updates>
-  <update>
-    <name>MokoCassiopeia</name>
-    <description>Moko Consulting site template based on Cassiopeia.</description>
-    <element>mokocassiopeia</element>
-    <type>template</type>
-    <version>03.09.05</version>
-    <client>site</client>
-    <tags>
-      <tag>stable</tag>
-    </tags>
-    <infourl title="MokoCassiopeia">https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03.09.04-rc</infourl>
-    <downloads>
-      <downloadurl type="full" format="zip">https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-rc/mokocassiopeia-03.09.05-rc.zip</downloadurl>
-    </downloads>
-    <sha256>fa0cd74ba37ede0dbb98256feca9a1f6f70b917b8487b778118de3d18b32074b</sha256>
-    <targetplatform name="joomla" version="(5|6)\..*" />
-    <maintainer>Moko Consulting</maintainer>
-    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
-  </update>
-</updates>

From 719eb77e3e3093c77e9b745870dc94b85d354117 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:04:42 -0500
Subject: [PATCH 07/21] Multi-channel updates.xml: stable, rc, and development

Single updates.xml now serves all three Joomla update channels.
Admins select their channel in Global Configuration and only see
the matching update entry:
- stable: v03.09.04 from main release
- rc: v03.09.05 from rc pre-release
- development: v03.09.05 from dev pre-release

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 updates.xml | 81 +++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 76 insertions(+), 5 deletions(-)

diff --git a/updates.xml b/updates.xml
index f485481..927bc75 100644
--- a/updates.xml
+++ b/updates.xml
@@ -11,10 +11,14 @@
  REPO: https://github.com/mokoconsulting-tech/MokoCassiopeia
  PATH: ./updates.xml
  VERSION: 03.09.05
- BRIEF: Update manifest XML file for MokoCassiopeia
+ BRIEF: Update manifest XML — stable, rc, and development channels
  -->
 
 <updates>
+
+  <!-- ══════════════════════════════════════════════════════════════
+       STABLE — production releases from main branch
+       ══════════════════════════════════════════════════════════════ -->
   <update>
     <name>MokoCassiopeia</name>
     <description>Moko Consulting's site template based on Cassiopeia.</description>
@@ -22,18 +26,18 @@
     <type>template</type>
     <client>site</client>
 
-    <version>03.09.05</version>
+    <version>03.09.04</version>
     <creationDate>2026-04-07</creationDate>
     <author>Jonathan Miller || Moko Consulting</author>
     <authorEmail>hello@mokoconsulting.tech</authorEmail>
     <copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
 
-    <infourl title='MokoCassiopeia'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03.09.04-rc</infourl>
+    <infourl title='MokoCassiopeia'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03</infourl>
 
     <downloads>
-      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-rc/mokocassiopeia-03.09.05-rc.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03/mokocassiopeia-03.09.04.zip</downloadurl>
     </downloads>
-    <sha256>fa0cd74ba37ede0dbb98256feca9a1f6f70b917b8487b778118de3d18b32074b</sha256>
+    <sha256>da85bf5a34cafadbae26df199ed36c04438e7dab440d046e0e4117d25510feaf</sha256>
 
     <tags>
       <tag>stable</tag>
@@ -44,4 +48,71 @@
 
     <targetplatform name='joomla' version='(5|6)\..*'/>
   </update>
+
+  <!-- ══════════════════════════════════════════════════════════════
+       RC — release candidates for testing and validation
+       ══════════════════════════════════════════════════════════════ -->
+  <update>
+    <name>MokoCassiopeia</name>
+    <description>MokoCassiopeia release candidate — testing only.</description>
+    <element>mokocassiopeia</element>
+    <type>template</type>
+    <client>site</client>
+
+    <version>03.09.05</version>
+    <creationDate>2026-04-07</creationDate>
+    <author>Jonathan Miller || Moko Consulting</author>
+    <authorEmail>hello@mokoconsulting.tech</authorEmail>
+    <copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
+
+    <infourl title='MokoCassiopeia RC'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03.09.04-rc</infourl>
+
+    <downloads>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-rc/mokocassiopeia-03.09.05-rc.zip</downloadurl>
+    </downloads>
+    <sha256>fa0cd74ba37ede0dbb98256feca9a1f6f70b917b8487b778118de3d18b32074b</sha256>
+
+    <tags>
+      <tag>rc</tag>
+    </tags>
+
+    <maintainer>Moko Consulting</maintainer>
+    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
+
+    <targetplatform name='joomla' version='(5|6)\..*'/>
+  </update>
+
+  <!-- ══════════════════════════════════════════════════════════════
+       DEVELOPMENT — latest dev branch builds, not for production
+       ══════════════════════════════════════════════════════════════ -->
+  <update>
+    <name>MokoCassiopeia</name>
+    <description>MokoCassiopeia development build — unstable.</description>
+    <element>mokocassiopeia</element>
+    <type>template</type>
+    <client>site</client>
+
+    <version>03.09.05</version>
+    <creationDate>2026-04-07</creationDate>
+    <author>Jonathan Miller || Moko Consulting</author>
+    <authorEmail>hello@mokoconsulting.tech</authorEmail>
+    <copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
+
+    <infourl title='MokoCassiopeia Dev'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03.09.04-dev</infourl>
+
+    <downloads>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-dev/mokocassiopeia-03.09.04-dev.zip</downloadurl>
+    </downloads>
+    <sha256>24ab00f1a3931c9b5372e9ecd58205648420da196a53c7e7f45cca615dd53864</sha256>
+
+    <tags>
+      <tag>development</tag>
+    </tags>
+
+    <maintainer>Moko Consulting</maintainer>
+    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
+
+    <targetplatform name='joomla' version='(5|6)\..*'/>
+  </update>
+
 </updates>

From 05540f5d860f5bf12e32a3799bc11747dea95c47 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:06:14 -0500
Subject: [PATCH 08/21] =?UTF-8?q?Remove=20scripts/=20directory=20=E2=80=94?=
 =?UTF-8?q?=20replaced=20by=20MokoStandards=20API?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Build, release, and utility functions are handled by the
MokoStandards enterprise API. Local scripts are no longer needed.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 scripts/README.md                | 74 ------------------------
 scripts/download-google-fonts.sh | 96 --------------------------------
 2 files changed, 170 deletions(-)
 delete mode 100644 scripts/README.md
 delete mode 100755 scripts/download-google-fonts.sh

diff --git a/scripts/README.md b/scripts/README.md
deleted file mode 100644
index 995b9dd..0000000
--- a/scripts/README.md
+++ /dev/null
@@ -1,74 +0,0 @@
-<!-- Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-
- SPDX-License-Identifier: GPL-3.0-or-later
-
- # FILE INFORMATION
- DEFGROUP: Joomla.Template.Site
- INGROUP: MokoCassiopeia.Documentation
- REPO: https://github.com/mokoconsulting-tech/MokoCassiopeia
- FILE: scripts/README.md
- VERSION: 03.09.04
- BRIEF: Documentation for utility scripts
- -->
-
-# Scripts — MokoCassiopeia
-
-Utility scripts for managing the MokoCassiopeia Joomla template.
-
-## Available Scripts
-
-### download-google-fonts.sh
-
-**Purpose**: Download Google Fonts for local hosting.
-
-**Usage**:
-```bash
-./scripts/download-google-fonts.sh
-```
-
-Downloads font files and generates CSS `@font-face` declarations for local serving, avoiding external CDN dependencies.
-
----
-
-## Build & Release
-
-Builds and releases are handled entirely by GitHub Actions workflows. There are no local build scripts.
-
-### auto-release.yml
-
-**Triggers**: Push to `version/*` branches, manual dispatch.
-
-**Process**:
-1. Reads version from `templateDetails.xml`
-2. Builds ZIP from `src/` contents
-3. Computes SHA-256 checksum
-4. Creates/updates GitHub Release with ZIP asset
-5. Updates `update.xml` with download URL and checksum
-
-### update-server.yml
-
-**Triggers**: Release published, manual dispatch.
-
-**Process**:
-1. Updates `updates.xml` with version, download URL, and SHA-256
-2. Commits changes to main
-
----
-
-## Release Process
-
-All releases are automated via CI. To release:
-
-1. Bump version in `src/templateDetails.xml`
-2. Merge to main
-3. The workflow detects the version, builds the ZIP, and creates the release
-
-**Only create releases when `src/` has changes.** Non-src changes (docs, workflows, scripts) are cleanup and do not require a release.
-
----
-
-## License
-
-All scripts are licensed under GPL-3.0-or-later.
-
-Copyright (C) 2026 Moko Consulting
diff --git a/scripts/download-google-fonts.sh b/scripts/download-google-fonts.sh
deleted file mode 100755
index dc861b1..0000000
--- a/scripts/download-google-fonts.sh
+++ /dev/null
@@ -1,96 +0,0 @@
-#!/bin/bash
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-# SPDX-License-Identifier: GPL-3.0-or-later
-#
-# Download Google Fonts for self-hosting
-# This script downloads Roboto, Noto Sans, and Fira Sans fonts
-
-set -e
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Target directory
-FONTS_DIR="../src/media/fonts"
-
-echo -e "${BLUE}╔════════════════════════════════════════════════╗${NC}"
-echo -e "${BLUE}║  Google Fonts Downloader for MokoCassiopeia  ║${NC}"
-echo -e "${BLUE}╚════════════════════════════════════════════════╝${NC}"
-echo ""
-
-# Check if fonts directory exists
-if [ ! -d "$FONTS_DIR" ]; then
-	echo -e "${RED}✗ Error: Fonts directory not found: $FONTS_DIR${NC}"
-	exit 1
-fi
-
-cd "$FONTS_DIR"
-
-echo -e "${YELLOW}Target directory: $(pwd)${NC}"
-echo ""
-
-# Function to download font CSS and extract font files
-download_font() {
-	local font_name="$1"
-	local font_url="$2"
-	local display_name="$3"
-	
-	echo -e "${GREEN}Downloading $display_name...${NC}"
-	
-	# Download CSS with user agent for woff2 format
-	css=$(curl -s -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" "$font_url")
-	
-	if [ -z "$css" ]; then
-		echo -e "${RED}  ✗ Failed to download CSS${NC}"
-		return 1
-	fi
-	
-	# Extract woff2 URLs
-	urls=$(echo "$css" | grep -oP 'https://fonts\.gstatic\.com[^\)]*\.woff2' || true)
-	
-	if [ -z "$urls" ]; then
-		echo -e "${RED}  ✗ No font URLs found in CSS${NC}"
-		return 1
-	fi
-	
-	count=0
-	while IFS= read -r url; do
-		if [ -z "$url" ]; then
-			continue
-		fi
-		
-		filename=$(basename "$url")
-		echo -e "  → Downloading ${filename}..."
-		
-		if curl -s "$url" -o "$filename"; then
-			size=$(du -h "$filename" | cut -f1)
-			echo -e "${GREEN}    ✓ Downloaded ($size)${NC}"
-			((count++))
-		else
-			echo -e "${RED}    ✗ Failed${NC}"
-		fi
-	done <<< "$urls"
-	
-	echo -e "${GREEN}  ✓ Downloaded $count font files${NC}"
-	echo ""
-}
-
-# Download fonts
-download_font "roboto" "https://fonts.googleapis.com/css2?family=Roboto:wght@100;300;400;700&display=swap" "Roboto"
-download_font "noto-sans" "https://fonts.googleapis.com/css2?family=Noto+Sans:wght@100;300;400;700&display=swap" "Noto Sans"
-download_font "fira-sans" "https://fonts.googleapis.com/css2?family=Fira+Sans:wght@100;300;400;700&display=swap" "Fira Sans"
-
-echo -e "${GREEN}╔════════════════════════════════════════════╗${NC}"
-echo -e "${GREEN}║  ✓ All fonts downloaded successfully!    ║${NC}"
-echo -e "${GREEN}╚════════════════════════════════════════════╝${NC}"
-echo ""
-echo -e "Font files saved to: ${BLUE}$(pwd)${NC}"
-echo ""
-echo "Next steps:"
-echo "1. Verify font files are present"
-echo "2. Update templateDetails.xml font options (if needed)"
-echo "3. Remove Google Fonts CDN preconnect links from PHP templates"

From 381f35a1ae67dc6e5d808fa323b1b3fe88bc8682 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:06:41 -0500
Subject: [PATCH 09/21] =?UTF-8?q?Restore=20download-google-fonts.sh=20?=
 =?UTF-8?q?=E2=80=94=20only=20local=20script=20needed?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 scripts/download-google-fonts.sh | 96 ++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 scripts/download-google-fonts.sh

diff --git a/scripts/download-google-fonts.sh b/scripts/download-google-fonts.sh
new file mode 100644
index 0000000..dc861b1
--- /dev/null
+++ b/scripts/download-google-fonts.sh
@@ -0,0 +1,96 @@
+#!/bin/bash
+# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# Download Google Fonts for self-hosting
+# This script downloads Roboto, Noto Sans, and Fira Sans fonts
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Target directory
+FONTS_DIR="../src/media/fonts"
+
+echo -e "${BLUE}╔════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║  Google Fonts Downloader for MokoCassiopeia  ║${NC}"
+echo -e "${BLUE}╚════════════════════════════════════════════════╝${NC}"
+echo ""
+
+# Check if fonts directory exists
+if [ ! -d "$FONTS_DIR" ]; then
+	echo -e "${RED}✗ Error: Fonts directory not found: $FONTS_DIR${NC}"
+	exit 1
+fi
+
+cd "$FONTS_DIR"
+
+echo -e "${YELLOW}Target directory: $(pwd)${NC}"
+echo ""
+
+# Function to download font CSS and extract font files
+download_font() {
+	local font_name="$1"
+	local font_url="$2"
+	local display_name="$3"
+	
+	echo -e "${GREEN}Downloading $display_name...${NC}"
+	
+	# Download CSS with user agent for woff2 format
+	css=$(curl -s -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" "$font_url")
+	
+	if [ -z "$css" ]; then
+		echo -e "${RED}  ✗ Failed to download CSS${NC}"
+		return 1
+	fi
+	
+	# Extract woff2 URLs
+	urls=$(echo "$css" | grep -oP 'https://fonts\.gstatic\.com[^\)]*\.woff2' || true)
+	
+	if [ -z "$urls" ]; then
+		echo -e "${RED}  ✗ No font URLs found in CSS${NC}"
+		return 1
+	fi
+	
+	count=0
+	while IFS= read -r url; do
+		if [ -z "$url" ]; then
+			continue
+		fi
+		
+		filename=$(basename "$url")
+		echo -e "  → Downloading ${filename}..."
+		
+		if curl -s "$url" -o "$filename"; then
+			size=$(du -h "$filename" | cut -f1)
+			echo -e "${GREEN}    ✓ Downloaded ($size)${NC}"
+			((count++))
+		else
+			echo -e "${RED}    ✗ Failed${NC}"
+		fi
+	done <<< "$urls"
+	
+	echo -e "${GREEN}  ✓ Downloaded $count font files${NC}"
+	echo ""
+}
+
+# Download fonts
+download_font "roboto" "https://fonts.googleapis.com/css2?family=Roboto:wght@100;300;400;700&display=swap" "Roboto"
+download_font "noto-sans" "https://fonts.googleapis.com/css2?family=Noto+Sans:wght@100;300;400;700&display=swap" "Noto Sans"
+download_font "fira-sans" "https://fonts.googleapis.com/css2?family=Fira+Sans:wght@100;300;400;700&display=swap" "Fira Sans"
+
+echo -e "${GREEN}╔════════════════════════════════════════════╗${NC}"
+echo -e "${GREEN}║  ✓ All fonts downloaded successfully!    ║${NC}"
+echo -e "${GREEN}╚════════════════════════════════════════════╝${NC}"
+echo ""
+echo -e "Font files saved to: ${BLUE}$(pwd)${NC}"
+echo ""
+echo "Next steps:"
+echo "1. Verify font files are present"
+echo "2. Update templateDetails.xml font options (if needed)"
+echo "3. Remove Google Fonts CDN preconnect links from PHP templates"

From 383a844482f16d408c0c9791c7b70f241c2ba043 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:09:00 -0500
Subject: [PATCH 10/21] ci: sync Joomla workflows + updates.xml from main

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .github/workflows/auto-release.yml  | 32 +++++++++++------------
 .github/workflows/ci-joomla.yml     |  6 ++---
 .github/workflows/repo_health.yml   |  6 ++---
 .github/workflows/update-server.yml | 40 ++++++++++++++---------------
 4 files changed, 42 insertions(+), 42 deletions(-)

diff --git a/.github/workflows/auto-release.yml b/.github/workflows/auto-release.yml
index 528d4cb..5acbe07 100644
--- a/.github/workflows/auto-release.yml
+++ b/.github/workflows/auto-release.yml
@@ -8,7 +8,7 @@
 # REPO: https://github.com/mokoconsulting-tech/MokoStandards
 # PATH: /templates/workflows/joomla/auto-release.yml.template
 # VERSION: 04.05.13
-# BRIEF: Joomla build & release — ZIP package, update.xml, SHA-256 checksum
+# BRIEF: Joomla build & release — ZIP package, updates.xml, SHA-256 checksum
 #
 # +========================================================================+
 # |                    BUILD & RELEASE PIPELINE (JOOMLA)                   |
@@ -20,10 +20,10 @@
 # |    1. Read version from README.md                                      |
 # |    3. Set platform version (Joomla <version>)                          |
 # |    4. Update [VERSION: XX.YY.ZZ] badges in markdown files              |
-# |    5. Write update.xml (Joomla update server XML)                      |
+# |    5. Write updates.xml (Joomla update server XML)                      |
 # |    6. Create git tag vXX.YY.ZZ                                        |
 # |    7a. Patch: update existing GitHub Release for this minor            |
-# |    8. Build ZIP, upload asset, write SHA-256 to update.xml             |
+# |    8. Build ZIP, upload asset, write SHA-256 to updates.xml             |
 # |                                                                        |
 # |  Every version change: archives main -> version/XX.YY branch           |
 # |  Patch 00 = development (no release). First release = patch 01.        |
@@ -259,8 +259,8 @@ jobs:
             fi
           done
 
-      # -- STEP 5: Write update.xml (Joomla update server) ---------------------
-      - name: "Step 5: Write update.xml"
+      # -- STEP 5: Write updates.xml (Joomla update server) ---------------------
+      - name: "Step 5: Write updates.xml"
         if: >-
           steps.version.outputs.skip != 'true' &&
           steps.check.outputs.already_released != 'true'
@@ -271,7 +271,7 @@ jobs:
           # -- Parse extension metadata from XML manifest ----------------
           MANIFEST=$(find . -maxdepth 2 -name "*.xml" -exec grep -l '<extension' {} \; 2>/dev/null | head -1)
           if [ -z "$MANIFEST" ]; then
-            echo "Warning: No Joomla XML manifest found — skipping update.xml" >> $GITHUB_STEP_SUMMARY
+            echo "Warning: No Joomla XML manifest found — skipping updates.xml" >> $GITHUB_STEP_SUMMARY
             exit 0
           fi
 
@@ -316,7 +316,7 @@ jobs:
           DOWNLOAD_URL="https://github.com/${REPO}/releases/download/v${VERSION}/${EXT_ELEMENT}-${VERSION}.zip"
           INFO_URL="https://github.com/${REPO}/releases/tag/v${VERSION}"
 
-          # -- Write update.xml (stable release) --------------------------
+          # -- Write updates.xml (stable release) --------------------------
           {
             printf '%s\n' '<?xml version="1.0" encoding="utf-8"?>'
             printf '%s\n' '<updates>'
@@ -341,9 +341,9 @@ jobs:
             printf '%s\n' '    <maintainerurl>https://mokoconsulting.tech</maintainerurl>'
             printf '%s\n' '  </update>'
             printf '%s\n' '</updates>'
-          } > update.xml
+          } > updates.xml
 
-          echo "update.xml: ${VERSION} (stable) — ${EXT_TYPE}/${EXT_ELEMENT}" >> $GITHUB_STEP_SUMMARY
+          echo "updates.xml: ${VERSION} (stable) — ${EXT_TYPE}/${EXT_ELEMENT}" >> $GITHUB_STEP_SUMMARY
 
       # -- Commit all changes ---------------------------------------------------
       - name: Commit release changes
@@ -472,19 +472,19 @@ jobs:
             gh release upload "$RELEASE_TAG" "/tmp/${PACKAGE_NAME}" 2>/dev/null || true
           }
 
-          # -- Update update.xml with SHA-256 for latest patch -------------
-          if [ -f "update.xml" ]; then
-            if grep -q '<sha256>' update.xml; then
-              sed -i "s|<sha256>.*</sha256>|<sha256>sha256:${SHA256}</sha256>|" update.xml
+          # -- Update updates.xml with SHA-256 for latest patch -------------
+          if [ -f "updates.xml" ]; then
+            if grep -q '<sha256>' updates.xml; then
+              sed -i "s|<sha256>.*</sha256>|<sha256>sha256:${SHA256}</sha256>|" updates.xml
             else
-              sed -i "s|</downloads>|</downloads>\n    <sha256>sha256:${SHA256}</sha256>|" update.xml
+              sed -i "s|</downloads>|</downloads>\n    <sha256>sha256:${SHA256}</sha256>|" updates.xml
             fi
 
             # Also update the download URL to point to this patch's ZIP
             DOWNLOAD_URL="https://github.com/${REPO}/releases/download/${RELEASE_TAG}/${PACKAGE_NAME}"
-            sed -i "s|<downloadurl[^>]*>[^<]*</downloadurl>|<downloadurl type=\"full\" format=\"zip\">${DOWNLOAD_URL}</downloadurl>|" update.xml
+            sed -i "s|<downloadurl[^>]*>[^<]*</downloadurl>|<downloadurl type=\"full\" format=\"zip\">${DOWNLOAD_URL}</downloadurl>|" updates.xml
 
-            git add update.xml
+            git add updates.xml
             git commit -m "chore(release): SHA-256 + download URL for ${VERSION} [skip ci]" \
               --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>" || true
             git push || true
diff --git a/.github/workflows/ci-joomla.yml b/.github/workflows/ci-joomla.yml
index d7995d2..190846e 100644
--- a/.github/workflows/ci-joomla.yml
+++ b/.github/workflows/ci-joomla.yml
@@ -312,11 +312,11 @@ jobs:
             fi
           fi
 
-          # Check update.xml exists
-          if [ -f "update.xml" ] || [ -f "updates.xml" ]; then
+          # Check updates.xml exists
+          if [ -f "updates.xml" ] || [ -f "updates.xml" ]; then
             echo "Update XML present." >> $GITHUB_STEP_SUMMARY
           else
-            echo "No update.xml found." >> $GITHUB_STEP_SUMMARY
+            echo "No updates.xml found." >> $GITHUB_STEP_SUMMARY
             ERRORS=$((ERRORS + 1))
           fi
 
diff --git a/.github/workflows/repo_health.yml b/.github/workflows/repo_health.yml
index 0129292..885203a 100644
--- a/.github/workflows/repo_health.yml
+++ b/.github/workflows/repo_health.yml
@@ -595,9 +595,9 @@ jobs:
             joomla_findings+=("No .ini language files found")
           fi
 
-          # update.xml must exist in root (Joomla update server)
-          if [ ! -f 'update.xml' ]; then
-            joomla_findings+=("update.xml missing in root (required for Joomla update server)")
+          # updates.xml must exist in root (Joomla update server)
+          if [ ! -f 'updates.xml' ]; then
+            joomla_findings+=("updates.xml missing in root (required for Joomla update server)")
           fi
 
           # index.html files for directory listing protection
diff --git a/.github/workflows/update-server.yml b/.github/workflows/update-server.yml
index 91d9365..4d4fc97 100644
--- a/.github/workflows/update-server.yml
+++ b/.github/workflows/update-server.yml
@@ -10,7 +10,7 @@
 # VERSION: 04.05.13
 # BRIEF: Update Joomla update server XML feed with stable/rc/dev entries
 #
-# Writes update.xml with multiple <update> entries:
+# Writes updates.xml with multiple <update> entries:
 #   - <tag>stable</tag>     on push to main (from auto-release)
 #   - <tag>rc</tag>         on push to rc/**
 #   - <tag>development</tag> on push to dev/**
@@ -47,7 +47,7 @@ permissions:
 
 jobs:
   update-xml:
-    name: Update update.xml
+    name: Update updates.xml
     runs-on: ubuntu-latest
 
     steps:
@@ -69,7 +69,7 @@ jobs:
             cd /tmp/mokostandards && composer install --no-dev --no-interaction --quiet 2>/dev/null || true
           fi
 
-      - name: Generate update.xml entry
+      - name: Generate updates.xml entry
         run: |
           BRANCH="${{ github.ref_name }}"
           REPO="${{ github.repository }}"
@@ -149,20 +149,20 @@ jobs:
 XMLEOF
 )
 
-          # ── Merge into update.xml ─────────────────────────────────────
-          if [ ! -f "update.xml" ]; then
+          # ── Merge into updates.xml ─────────────────────────────────────
+          if [ ! -f "updates.xml" ]; then
             # Create fresh
-            printf '%s\n' '<?xml version="1.0" encoding="utf-8"?>' > update.xml
-            printf '%s\n' '<updates>' >> update.xml
-            echo "$NEW_ENTRY" >> update.xml
-            printf '%s\n' '</updates>' >> update.xml
+            printf '%s\n' '<?xml version="1.0" encoding="utf-8"?>' > updates.xml
+            printf '%s\n' '<updates>' >> updates.xml
+            echo "$NEW_ENTRY" >> updates.xml
+            printf '%s\n' '</updates>' >> updates.xml
           else
             # Remove existing entry for this stability, add new one
             # Use python for reliable XML manipulation
             python3 -c "
 import re, sys
 
-with open('update.xml', 'r') as f:
+with open('updates.xml', 'r') as f:
     content = f.read()
 
 # Remove existing entry with this stability tag
@@ -176,29 +176,29 @@ content = content.replace('</updates>', new_entry + '\n</updates>')
 # Clean up empty lines
 content = re.sub(r'\n{3,}', '\n\n', content)
 
-with open('update.xml', 'w') as f:
+with open('updates.xml', 'w') as f:
     f.write(content)
 " 2>/dev/null || {
               # Fallback: just rewrite the whole file if python fails
               # Keep existing stable entry if present
               STABLE_ENTRY=""
-              if [ "$STABILITY" != "stable" ] && grep -q '<tag>stable</tag>' update.xml; then
-                STABLE_ENTRY=$(sed -n '/<update>/,/<\/update>/{ /<tag>stable<\/tag>/,/<\/update>/p; /<update>/,/<tag>stable<\/tag>/p }' update.xml | sort -u)
+              if [ "$STABILITY" != "stable" ] && grep -q '<tag>stable</tag>' updates.xml; then
+                STABLE_ENTRY=$(sed -n '/<update>/,/<\/update>/{ /<tag>stable<\/tag>/,/<\/update>/p; /<update>/,/<tag>stable<\/tag>/p }' updates.xml | sort -u)
               fi
               RC_ENTRY=""
-              if [ "$STABILITY" != "rc" ] && grep -q '<tag>rc</tag>' update.xml; then
+              if [ "$STABILITY" != "rc" ] && grep -q '<tag>rc</tag>' updates.xml; then
                 RC_ENTRY=$(python3 -c "
 import re
-with open('update.xml') as f: c = f.read()
+with open('updates.xml') as f: c = f.read()
 m = re.search(r'(<update>.*?<tag>rc</tag>.*?</update>)', c, re.DOTALL)
 if m: print(m.group(1))
 " 2>/dev/null || true)
               fi
               DEV_ENTRY=""
-              if [ "$STABILITY" != "development" ] && grep -q '<tag>development</tag>' update.xml; then
+              if [ "$STABILITY" != "development" ] && grep -q '<tag>development</tag>' updates.xml; then
                 DEV_ENTRY=$(python3 -c "
 import re
-with open('update.xml') as f: c = f.read()
+with open('updates.xml') as f: c = f.read()
 m = re.search(r'(<update>.*?<tag>development</tag>.*?</update>)', c, re.DOTALL)
 if m: print(m.group(1))
 " 2>/dev/null || true)
@@ -212,16 +212,16 @@ if m: print(m.group(1))
                 [ -n "$DEV_ENTRY" ] && echo "$DEV_ENTRY"
                 echo "$NEW_ENTRY"
                 printf '%s\n' '</updates>'
-              } > update.xml
+              } > updates.xml
             }
           fi
 
           # Commit
           git config --local user.email "github-actions[bot]@users.noreply.github.com"
           git config --local user.name "github-actions[bot]"
-          git add update.xml
+          git add updates.xml
           git diff --cached --quiet || {
-            git commit -m "chore: update update.xml (${STABILITY}: ${DISPLAY_VERSION}) [skip ci]" \
+            git commit -m "chore: update updates.xml (${STABILITY}: ${DISPLAY_VERSION}) [skip ci]" \
               --author="github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
             git push
           }

From 12a15b98a1255e7364085f0da5ebf5e78839632e Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:12:31 -0500
Subject: [PATCH 11/21] Convert download-google-fonts from bash to PHP

Replace .sh with .php so it runs anywhere PHP is available
(no bash/curl dependency). Same functionality: fetches woff2
files from Google Fonts API for Roboto, Noto Sans, Fira Sans.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 scripts/download-google-fonts.php | 73 +++++++++++++++++++++++
 scripts/download-google-fonts.sh  | 96 -------------------------------
 2 files changed, 73 insertions(+), 96 deletions(-)
 create mode 100644 scripts/download-google-fonts.php
 delete mode 100644 scripts/download-google-fonts.sh

diff --git a/scripts/download-google-fonts.php b/scripts/download-google-fonts.php
new file mode 100644
index 0000000..98ea144
--- /dev/null
+++ b/scripts/download-google-fonts.php
@@ -0,0 +1,73 @@
+<?php
+/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+ *
+ * This file is part of a Moko Consulting project.
+ *
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ *
+ * # FILE INFORMATION
+ * DEFGROUP: Joomla.Template.Site
+ * INGROUP: MokoCassiopeia
+ * PATH: scripts/download-google-fonts.php
+ * VERSION: 03.09.05
+ * BRIEF: Download Google Fonts (woff2) for local self-hosting
+ */
+
+$fontsDir = __DIR__ . '/../src/media/fonts';
+
+if (!is_dir($fontsDir)) {
+    fwrite(STDERR, "Error: Fonts directory not found: {$fontsDir}\n");
+    exit(1);
+}
+
+$fonts = [
+    'Roboto'    => 'https://fonts.googleapis.com/css2?family=Roboto:wght@100;300;400;700&display=swap',
+    'Noto Sans' => 'https://fonts.googleapis.com/css2?family=Noto+Sans:wght@100;300;400;700&display=swap',
+    'Fira Sans' => 'https://fonts.googleapis.com/css2?family=Fira+Sans:wght@100;300;400;700&display=swap',
+];
+
+$userAgent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36';
+
+echo "Google Fonts Downloader for MokoCassiopeia\n";
+echo str_repeat('=', 48) . "\n";
+echo "Target: {$fontsDir}\n\n";
+
+foreach ($fonts as $name => $url) {
+    echo "Downloading {$name}...\n";
+
+    $ctx = stream_context_create(['http' => ['header' => "User-Agent: {$userAgent}\r\n"]]);
+    $css = @file_get_contents($url, false, $ctx);
+
+    if ($css === false) {
+        fwrite(STDERR, "  FAIL: could not fetch CSS for {$name}\n");
+        continue;
+    }
+
+    preg_match_all('#https://fonts\.gstatic\.com[^)]*\.woff2#', $css, $matches);
+
+    if (empty($matches[0])) {
+        fwrite(STDERR, "  FAIL: no woff2 URLs found for {$name}\n");
+        continue;
+    }
+
+    $count = 0;
+    foreach ($matches[0] as $fontUrl) {
+        $filename = basename($fontUrl);
+        $dest     = $fontsDir . '/' . $filename;
+
+        $data = @file_get_contents($fontUrl, false, $ctx);
+        if ($data === false) {
+            fwrite(STDERR, "  FAIL: {$filename}\n");
+            continue;
+        }
+
+        file_put_contents($dest, $data);
+        $size = round(strlen($data) / 1024, 1);
+        echo "  OK: {$filename} ({$size} KB)\n";
+        $count++;
+    }
+
+    echo "  {$count} file(s) downloaded\n\n";
+}
+
+echo "Done.\n";
diff --git a/scripts/download-google-fonts.sh b/scripts/download-google-fonts.sh
deleted file mode 100644
index dc861b1..0000000
--- a/scripts/download-google-fonts.sh
+++ /dev/null
@@ -1,96 +0,0 @@
-#!/bin/bash
-# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
-# SPDX-License-Identifier: GPL-3.0-or-later
-#
-# Download Google Fonts for self-hosting
-# This script downloads Roboto, Noto Sans, and Fira Sans fonts
-
-set -e
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-# Target directory
-FONTS_DIR="../src/media/fonts"
-
-echo -e "${BLUE}╔════════════════════════════════════════════════╗${NC}"
-echo -e "${BLUE}║  Google Fonts Downloader for MokoCassiopeia  ║${NC}"
-echo -e "${BLUE}╚════════════════════════════════════════════════╝${NC}"
-echo ""
-
-# Check if fonts directory exists
-if [ ! -d "$FONTS_DIR" ]; then
-	echo -e "${RED}✗ Error: Fonts directory not found: $FONTS_DIR${NC}"
-	exit 1
-fi
-
-cd "$FONTS_DIR"
-
-echo -e "${YELLOW}Target directory: $(pwd)${NC}"
-echo ""
-
-# Function to download font CSS and extract font files
-download_font() {
-	local font_name="$1"
-	local font_url="$2"
-	local display_name="$3"
-	
-	echo -e "${GREEN}Downloading $display_name...${NC}"
-	
-	# Download CSS with user agent for woff2 format
-	css=$(curl -s -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36" "$font_url")
-	
-	if [ -z "$css" ]; then
-		echo -e "${RED}  ✗ Failed to download CSS${NC}"
-		return 1
-	fi
-	
-	# Extract woff2 URLs
-	urls=$(echo "$css" | grep -oP 'https://fonts\.gstatic\.com[^\)]*\.woff2' || true)
-	
-	if [ -z "$urls" ]; then
-		echo -e "${RED}  ✗ No font URLs found in CSS${NC}"
-		return 1
-	fi
-	
-	count=0
-	while IFS= read -r url; do
-		if [ -z "$url" ]; then
-			continue
-		fi
-		
-		filename=$(basename "$url")
-		echo -e "  → Downloading ${filename}..."
-		
-		if curl -s "$url" -o "$filename"; then
-			size=$(du -h "$filename" | cut -f1)
-			echo -e "${GREEN}    ✓ Downloaded ($size)${NC}"
-			((count++))
-		else
-			echo -e "${RED}    ✗ Failed${NC}"
-		fi
-	done <<< "$urls"
-	
-	echo -e "${GREEN}  ✓ Downloaded $count font files${NC}"
-	echo ""
-}
-
-# Download fonts
-download_font "roboto" "https://fonts.googleapis.com/css2?family=Roboto:wght@100;300;400;700&display=swap" "Roboto"
-download_font "noto-sans" "https://fonts.googleapis.com/css2?family=Noto+Sans:wght@100;300;400;700&display=swap" "Noto Sans"
-download_font "fira-sans" "https://fonts.googleapis.com/css2?family=Fira+Sans:wght@100;300;400;700&display=swap" "Fira Sans"
-
-echo -e "${GREEN}╔════════════════════════════════════════════╗${NC}"
-echo -e "${GREEN}║  ✓ All fonts downloaded successfully!    ║${NC}"
-echo -e "${GREEN}╚════════════════════════════════════════════╝${NC}"
-echo ""
-echo -e "Font files saved to: ${BLUE}$(pwd)${NC}"
-echo ""
-echo "Next steps:"
-echo "1. Verify font files are present"
-echo "2. Update templateDetails.xml font options (if needed)"
-echo "3. Remove Google Fonts CDN preconnect links from PHP templates"

From e7d8785f15bf12bf10615211aaf4688275aacc07 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:18:13 -0500
Subject: [PATCH 12/21] ci: sync workflows from main [skip ci]

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .github/workflows/update-server.yml | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/update-server.yml b/.github/workflows/update-server.yml
index 4d4fc97..cc34448 100644
--- a/.github/workflows/update-server.yml
+++ b/.github/workflows/update-server.yml
@@ -121,9 +121,32 @@ jobs:
 
           MAJOR=$(echo "$VERSION" | awk -F. '{print $1}')
           RELEASE_TAG="v${MAJOR}"
-          DOWNLOAD_URL="https://github.com/${REPO}/releases/download/${RELEASE_TAG}/${EXT_ELEMENT}-${VERSION}.zip"
+          PACKAGE_NAME="${EXT_ELEMENT}-${DISPLAY_VERSION}.zip"
+          DOWNLOAD_URL="https://github.com/${REPO}/releases/download/${RELEASE_TAG}/${PACKAGE_NAME}"
           INFO_URL="https://github.com/${REPO}"
 
+          # ── Build install-ready ZIP ─────────────────────────────────
+          SOURCE_DIR="src"
+          [ ! -d "$SOURCE_DIR" ] && SOURCE_DIR="htdocs"
+          if [ -d "$SOURCE_DIR" ]; then
+            cd "$SOURCE_DIR"
+            zip -r "/tmp/${PACKAGE_NAME}" .
+            cd ..
+
+            SHA256=$(sha256sum "/tmp/${PACKAGE_NAME}" | cut -d' ' -f1)
+
+            # Ensure draft release exists for this major
+            gh release view "$RELEASE_TAG" --json tagName > /dev/null 2>&1 || \
+              gh release create "$RELEASE_TAG" --title "v${MAJOR}" --notes "Development release" --draft --target main 2>/dev/null || true
+
+            # Upload ZIP to the major release
+            gh release upload "$RELEASE_TAG" "/tmp/${PACKAGE_NAME}" --clobber 2>/dev/null || true
+
+            echo "Package: ${PACKAGE_NAME} (SHA: ${SHA256})" >> $GITHUB_STEP_SUMMARY
+          else
+            SHA256=""
+          fi
+
           # ── Build the new entry ───────────────────────────────────────
           NEW_ENTRY=$(cat <<XMLEOF
   <update>
@@ -141,6 +164,7 @@ jobs:
     <downloads>
       <downloadurl type="full" format="zip">${DOWNLOAD_URL}</downloadurl>
     </downloads>
+    $([ -n "$SHA256" ] && echo "    <sha256>sha256:${SHA256}</sha256>")
     ${TARGET_PLATFORM}
     $([ -n "$PHP_TAG" ] && echo "    ${PHP_TAG}")
     <maintainer>Moko Consulting</maintainer>

From 05bbe91e292a630ab730e59dbf63d3fca6c229c7 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:34:59 -0500
Subject: [PATCH 13/21] Reduce search position to 15% width on desktop

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/media/css/template.css | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/media/css/template.css b/src/media/css/template.css
index d00e024..b0611b2 100644
--- a/src/media/css/template.css
+++ b/src/media/css/template.css
@@ -18694,8 +18694,8 @@ nav[data-toggle=toc] .nav-link.active+ul{
 	}
 
 	.container-header .container-search {
-		flex: 0 0 16.667%;
-		max-width: 16.667%;
+		flex: 0 0 15%;
+		max-width: 15%;
 		margin-top: 0;
 	}
 }

From 918bf0ca1b2630b2c8d4308f82a13593454a1520 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:36:55 -0500
Subject: [PATCH 14/21] Fix updates.xml dev channel download URL and SHA

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 updates.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/updates.xml b/updates.xml
index 927bc75..b25c606 100644
--- a/updates.xml
+++ b/updates.xml
@@ -101,9 +101,9 @@
     <infourl title='MokoCassiopeia Dev'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03.09.04-dev</infourl>
 
     <downloads>
-      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-dev/mokocassiopeia-03.09.04-dev.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-dev/mokocassiopeia-dev.zip</downloadurl>
     </downloads>
-    <sha256>24ab00f1a3931c9b5372e9ecd58205648420da196a53c7e7f45cca615dd53864</sha256>
+    <sha256>e585c4b039f6c88ea7a566b92189ed2d1ab731cd7110727659d6cb08b729585d</sha256>
 
     <tags>
       <tag>development</tag>

From e00d71ee1c17955062da52a6ad319a46774a7fd0 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:38:06 -0500
Subject: [PATCH 15/21] ci: sync workflows [skip ci]

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .github/workflows/auto-release.yml          | 4 ++--
 .github/workflows/ci-joomla.yml             | 2 +-
 .github/workflows/standards-compliance.yml  | 6 +++---
 .github/workflows/sync-version-on-merge.yml | 2 +-
 .github/workflows/update-server.yml         | 2 +-
 5 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/auto-release.yml b/.github/workflows/auto-release.yml
index 5acbe07..f064ceb 100644
--- a/.github/workflows/auto-release.yml
+++ b/.github/workflows/auto-release.yml
@@ -69,7 +69,7 @@ jobs:
           GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
           COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
         run: |
-          git clone --depth 1 --branch version/04.05 --quiet \
+          git clone --depth 1 --branch version/04 --quiet \
             "https://x-access-token:${GH_TOKEN}@github.com/mokoconsulting-tech/MokoStandards.git" \
             /tmp/mokostandards
           cd /tmp/mokostandards
@@ -93,7 +93,7 @@ jobs:
           MINOR_NUM=$(echo "$VERSION" | awk -F. '{print $2}')
 
           echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-          echo "branch=version/${MINOR}" >> "$GITHUB_OUTPUT"
+          echo "branch=version/${MAJOR}" >> "$GITHUB_OUTPUT"
           echo "minor=$MINOR" >> "$GITHUB_OUTPUT"
           echo "major=$MAJOR" >> "$GITHUB_OUTPUT"
           echo "release_tag=v${MAJOR}" >> "$GITHUB_OUTPUT"
diff --git a/.github/workflows/ci-joomla.yml b/.github/workflows/ci-joomla.yml
index 190846e..6281236 100644
--- a/.github/workflows/ci-joomla.yml
+++ b/.github/workflows/ci-joomla.yml
@@ -57,7 +57,7 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
         run: |
-          git clone --depth 1 --branch version/04.05 --quiet \
+          git clone --depth 1 --branch version/04 --quiet \
             "https://x-access-token:${GH_TOKEN}@github.com/mokoconsulting-tech/MokoStandards.git" \
             /tmp/mokostandards
 
diff --git a/.github/workflows/standards-compliance.yml b/.github/workflows/standards-compliance.yml
index df8413c..773279d 100644
--- a/.github/workflows/standards-compliance.yml
+++ b/.github/workflows/standards-compliance.yml
@@ -509,7 +509,7 @@ jobs:
           GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
           COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
         run: |
-          git clone --depth 1 --branch version/04.05 --quiet \
+          git clone --depth 1 --branch version/04 --quiet \
             "https://x-access-token:${GH_TOKEN}@github.com/mokoconsulting-tech/MokoStandards.git" \
             /tmp/mokostandards 2>/dev/null || true
           if [ -d "/tmp/mokostandards" ] && [ -f "/tmp/mokostandards/composer.json" ]; then
@@ -1978,7 +1978,7 @@ jobs:
           else
             echo "No composer.json — pulling MokoStandards tools"
             if [ ! -d "/tmp/mokostandards" ]; then
-              git clone --depth 1 --branch version/04.05 --quiet \
+              git clone --depth 1 --branch version/04 --quiet \
                 "https://x-access-token:${GH_TOKEN}@github.com/mokoconsulting-tech/MokoStandards.git" \
                 /tmp/mokostandards 2>/dev/null || true
               if [ -f "/tmp/mokostandards/composer.json" ]; then
@@ -2050,7 +2050,7 @@ jobs:
           else
             echo "No composer.json — pulling MokoStandards tools"
             if [ ! -d "/tmp/mokostandards" ]; then
-              git clone --depth 1 --branch version/04.05 --quiet \
+              git clone --depth 1 --branch version/04 --quiet \
                 "https://x-access-token:${GH_TOKEN}@github.com/mokoconsulting-tech/MokoStandards.git" \
                 /tmp/mokostandards 2>/dev/null || true
               if [ -f "/tmp/mokostandards/composer.json" ]; then
diff --git a/.github/workflows/sync-version-on-merge.yml b/.github/workflows/sync-version-on-merge.yml
index 7b2ef6c..052a7ca 100644
--- a/.github/workflows/sync-version-on-merge.yml
+++ b/.github/workflows/sync-version-on-merge.yml
@@ -58,7 +58,7 @@ jobs:
           GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
           COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
         run: |
-          git clone --depth 1 --branch version/04.05 --quiet \
+          git clone --depth 1 --branch version/04 --quiet \
             "https://x-access-token:${GH_TOKEN}@github.com/mokoconsulting-tech/MokoStandards.git" \
             /tmp/mokostandards
           cd /tmp/mokostandards
diff --git a/.github/workflows/update-server.yml b/.github/workflows/update-server.yml
index cc34448..fad30ff 100644
--- a/.github/workflows/update-server.yml
+++ b/.github/workflows/update-server.yml
@@ -62,7 +62,7 @@ jobs:
           GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
           COMPOSER_AUTH: '{"github-oauth":{"github.com":"${{ secrets.GH_TOKEN || github.token }}"}}'
         run: |
-          git clone --depth 1 --branch version/04.05 --quiet \
+          git clone --depth 1 --branch version/04 --quiet \
             "https://x-access-token:${GH_TOKEN}@github.com/mokoconsulting-tech/MokoStandards.git" \
             /tmp/mokostandards 2>/dev/null || true
           if [ -d "/tmp/mokostandards" ] && [ -f "/tmp/mokostandards/composer.json" ]; then

From 98485b650adb2c58d62afabcc5131a3d41a61d6d Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:40:33 -0500
Subject: [PATCH 16/21] chore: bump dev version to 03.09.06

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/templateDetails.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/templateDetails.xml b/src/templateDetails.xml
index fe396eb..99e7377 100644
--- a/src/templateDetails.xml
+++ b/src/templateDetails.xml
@@ -36,7 +36,7 @@
 	  </server>
 	</updateservers>
 	<name>MokoCassiopeia</name>
-	<version>03.09.05</version>
+	<version>03.09.06</version>
 	<scriptfile>script.php</scriptfile>
 	<creationDate>2026-03-26</creationDate>
 	<author>Jonathan Miller || Moko Consulting</author>

From be5646830585313c0cecb21d4946624311f896d6 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:52:32 -0500
Subject: [PATCH 17/21] Point updates.xml to development and release-candidate
 tags

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 updates.xml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/updates.xml b/updates.xml
index b25c606..39ab1ee 100644
--- a/updates.xml
+++ b/updates.xml
@@ -59,18 +59,18 @@
     <type>template</type>
     <client>site</client>
 
-    <version>03.09.05</version>
+    <version>03.09.06</version>
     <creationDate>2026-04-07</creationDate>
     <author>Jonathan Miller || Moko Consulting</author>
     <authorEmail>hello@mokoconsulting.tech</authorEmail>
     <copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
 
-    <infourl title='MokoCassiopeia RC'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03.09.04-rc</infourl>
+    <infourl title='MokoCassiopeia RC'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/release-candidate</infourl>
 
     <downloads>
-      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-rc/mokocassiopeia-03.09.05-rc.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/release-candidate/mokocassiopeia-rc.zip</downloadurl>
     </downloads>
-    <sha256>fa0cd74ba37ede0dbb98256feca9a1f6f70b917b8487b778118de3d18b32074b</sha256>
+    <sha256>7f75cb1d2a1a9477fbbb0d742569afb1009d79755f23876e4e20cc89d7770720</sha256>
 
     <tags>
       <tag>rc</tag>
@@ -92,18 +92,18 @@
     <type>template</type>
     <client>site</client>
 
-    <version>03.09.05</version>
+    <version>03.09.06</version>
     <creationDate>2026-04-07</creationDate>
     <author>Jonathan Miller || Moko Consulting</author>
     <authorEmail>hello@mokoconsulting.tech</authorEmail>
     <copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
 
-    <infourl title='MokoCassiopeia Dev'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/v03.09.04-dev</infourl>
+    <infourl title='MokoCassiopeia Dev'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/development</infourl>
 
     <downloads>
-      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/v03.09.04-dev/mokocassiopeia-dev.zip</downloadurl>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/development/mokocassiopeia-dev.zip</downloadurl>
     </downloads>
-    <sha256>e585c4b039f6c88ea7a566b92189ed2d1ab731cd7110727659d6cb08b729585d</sha256>
+    <sha256>7f75cb1d2a1a9477fbbb0d742569afb1009d79755f23876e4e20cc89d7770720</sha256>
 
     <tags>
       <tag>development</tag>

From 6ff481198aa23b5ef763ff4a0ccd4e7e7097d356 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:55:18 -0500
Subject: [PATCH 18/21] ci: sync workflows [skip ci]

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .github/workflows/auto-dev-issue.yml | 26 ++++-------
 .github/workflows/auto-release.yml   | 70 +++++++++++++++++++---------
 .github/workflows/update-server.yml  | 13 +++++-
 3 files changed, 68 insertions(+), 41 deletions(-)

diff --git a/.github/workflows/auto-dev-issue.yml b/.github/workflows/auto-dev-issue.yml
index 38730ab..38c6a53 100644
--- a/.github/workflows/auto-dev-issue.yml
+++ b/.github/workflows/auto-dev-issue.yml
@@ -156,30 +156,22 @@ jobs:
             done
           fi
 
-          # ── RC: Create or update draft release ────────────────────────────
+          # ── RC: Create or update release-candidate release ──────────────
           if [[ "$BRANCH" == rc/* ]]; then
-            MAJOR=$(echo "$VERSION" | awk -F. '{print $1}')
-            RELEASE_TAG="v${MAJOR}"
-            DRAFT_EXISTS=$(gh release view "$RELEASE_TAG" --json isDraft -q .isDraft 2>/dev/null || true)
+            RELEASE_TAG="release-candidate"
+            EXISTING=$(gh release view "$RELEASE_TAG" --json tagName -q .tagName 2>/dev/null || true)
 
-            if [ -z "$DRAFT_EXISTS" ]; then
-              # No release exists — create draft
+            if [ -z "$EXISTING" ]; then
               gh release create "$RELEASE_TAG" \
-                --title "v${MAJOR} (RC: ${VERSION})" \
+                --title "release-candidate (${VERSION})" \
                 --notes "## Release Candidate ${VERSION}\n\nRC branch: \`${BRANCH}\`\nTracking issue: ${PARENT_URL}" \
-                --draft \
+                --prerelease \
                 --target main 2>/dev/null || true
-              echo "Draft release created: ${RELEASE_TAG}" >> $GITHUB_STEP_SUMMARY
-            elif [ "$DRAFT_EXISTS" = "true" ]; then
-              # Draft exists — update title
-              gh release edit "$RELEASE_TAG" \
-                --title "v${MAJOR} (RC: ${VERSION})" --draft 2>/dev/null || true
-              echo "Draft release updated: ${RELEASE_TAG}" >> $GITHUB_STEP_SUMMARY
+              echo "RC release created: ${RELEASE_TAG}" >> $GITHUB_STEP_SUMMARY
             else
-              # Release exists and is published — set back to draft for RC
               gh release edit "$RELEASE_TAG" \
-                --title "v${MAJOR} (RC: ${VERSION})" --draft 2>/dev/null || true
-              echo "Release ${RELEASE_TAG} set to draft for RC" >> $GITHUB_STEP_SUMMARY
+                --title "release-candidate (${VERSION})" --prerelease 2>/dev/null || true
+              echo "RC release updated: ${RELEASE_TAG}" >> $GITHUB_STEP_SUMMARY
             fi
           fi
 
diff --git a/.github/workflows/auto-release.yml b/.github/workflows/auto-release.yml
index f064ceb..3e1caf3 100644
--- a/.github/workflows/auto-release.yml
+++ b/.github/workflows/auto-release.yml
@@ -316,34 +316,60 @@ jobs:
           DOWNLOAD_URL="https://github.com/${REPO}/releases/download/v${VERSION}/${EXT_ELEMENT}-${VERSION}.zip"
           INFO_URL="https://github.com/${REPO}/releases/tag/v${VERSION}"
 
-          # -- Write updates.xml (stable release) --------------------------
+          # -- Build stable entry ──────────────────────────────────────
+          STABLE_ENTRY=$(cat <<XMLEOF
+  <update>
+    <name>${EXT_NAME}</name>
+    <description>${EXT_NAME} update</description>
+    <element>${EXT_ELEMENT}</element>
+    <type>${EXT_TYPE}</type>
+    <version>${VERSION}</version>
+    $([ -n "$CLIENT_TAG" ] && echo "    ${CLIENT_TAG}")
+    $([ -n "$FOLDER_TAG" ] && echo "    ${FOLDER_TAG}")
+    <tags>
+      <tag>stable</tag>
+    </tags>
+    <infourl title="${EXT_NAME}">${INFO_URL}</infourl>
+    <downloads>
+      <downloadurl type="full" format="zip">${DOWNLOAD_URL}</downloadurl>
+    </downloads>
+    ${TARGET_PLATFORM}
+    $([ -n "$PHP_TAG" ] && echo "    ${PHP_TAG}")
+    <maintainer>Moko Consulting</maintainer>
+    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
+  </update>
+XMLEOF
+)
+
+          # -- Write updates.xml preserving dev/rc entries ──────────────
+          # Extract existing dev and rc entries if present
+          RC_ENTRY=""
+          DEV_ENTRY=""
+          if [ -f "updates.xml" ]; then
+            RC_ENTRY=$(python3 -c "
+import re
+with open('updates.xml') as f: c = f.read()
+m = re.search(r'(  <update>.*?<tag>rc</tag>.*?</update>)', c, re.DOTALL)
+if m: print(m.group(1))
+" 2>/dev/null || true)
+            DEV_ENTRY=$(python3 -c "
+import re
+with open('updates.xml') as f: c = f.read()
+m = re.search(r'(  <update>.*?<tag>development</tag>.*?</update>)', c, re.DOTALL)
+if m: print(m.group(1))
+" 2>/dev/null || true)
+          fi
+
           {
             printf '%s\n' '<?xml version="1.0" encoding="utf-8"?>'
             printf '%s\n' '<updates>'
-            printf '%s\n' '  <update>'
-            printf '%s\n' "    <name>${EXT_NAME}</name>"
-            printf '%s\n' "    <description>${EXT_NAME} update</description>"
-            printf '%s\n' "    <element>${EXT_ELEMENT}</element>"
-            printf '%s\n' "    <type>${EXT_TYPE}</type>"
-            printf '%s\n' "    <version>${VERSION}</version>"
-            [ -n "$CLIENT_TAG" ] && printf '%s\n' "    ${CLIENT_TAG}"
-            [ -n "$FOLDER_TAG" ] && printf '%s\n' "    ${FOLDER_TAG}"
-            printf '%s\n' '    <tags>'
-            printf '%s\n' '      <tag>stable</tag>'
-            printf '%s\n' '    </tags>'
-            printf '%s\n' "    <infourl title=\"${EXT_NAME}\">${INFO_URL}</infourl>"
-            printf '%s\n' '    <downloads>'
-            printf '%s\n' "      <downloadurl type=\"full\" format=\"zip\">${DOWNLOAD_URL}</downloadurl>"
-            printf '%s\n' '    </downloads>'
-            printf '%s\n' "    ${TARGET_PLATFORM}"
-            [ -n "$PHP_TAG" ] && printf '%s\n' "    ${PHP_TAG}"
-            printf '%s\n' '    <maintainer>Moko Consulting</maintainer>'
-            printf '%s\n' '    <maintainerurl>https://mokoconsulting.tech</maintainerurl>'
-            printf '%s\n' '  </update>'
+            echo "$STABLE_ENTRY"
+            [ -n "$RC_ENTRY" ] && echo "$RC_ENTRY"
+            [ -n "$DEV_ENTRY" ] && echo "$DEV_ENTRY"
             printf '%s\n' '</updates>'
           } > updates.xml
 
-          echo "updates.xml: ${VERSION} (stable) — ${EXT_TYPE}/${EXT_ELEMENT}" >> $GITHUB_STEP_SUMMARY
+          echo "updates.xml: ${VERSION} (stable + rc/dev preserved)" >> $GITHUB_STEP_SUMMARY
 
       # -- Commit all changes ---------------------------------------------------
       - name: Commit release changes
diff --git a/.github/workflows/update-server.yml b/.github/workflows/update-server.yml
index fad30ff..28a6dd7 100644
--- a/.github/workflows/update-server.yml
+++ b/.github/workflows/update-server.yml
@@ -120,7 +120,16 @@ jobs:
           [ "$STABILITY" = "development" ] && DISPLAY_VERSION="${VERSION}-dev"
 
           MAJOR=$(echo "$VERSION" | awk -F. '{print $1}')
-          RELEASE_TAG="v${MAJOR}"
+
+          # Each stability level has its own release tag
+          if [ "$STABILITY" = "rc" ]; then
+            RELEASE_TAG="release-candidate"
+          elif [ "$STABILITY" = "development" ]; then
+            RELEASE_TAG="development"
+          else
+            RELEASE_TAG="v${MAJOR}"
+          fi
+
           PACKAGE_NAME="${EXT_ELEMENT}-${DISPLAY_VERSION}.zip"
           DOWNLOAD_URL="https://github.com/${REPO}/releases/download/${RELEASE_TAG}/${PACKAGE_NAME}"
           INFO_URL="https://github.com/${REPO}"
@@ -137,7 +146,7 @@ jobs:
 
             # Ensure draft release exists for this major
             gh release view "$RELEASE_TAG" --json tagName > /dev/null 2>&1 || \
-              gh release create "$RELEASE_TAG" --title "v${MAJOR}" --notes "Development release" --draft --target main 2>/dev/null || true
+              gh release create "$RELEASE_TAG" --title "${RELEASE_TAG} (${DISPLAY_VERSION})" --notes "${STABILITY} release" --prerelease --target main 2>/dev/null || true
 
             # Upload ZIP to the major release
             gh release upload "$RELEASE_TAG" "/tmp/${PACKAGE_NAME}" --clobber 2>/dev/null || true

From 6a0715571286fa6ac1a58013e2b1d112d65dacbc Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 19:59:42 -0500
Subject: [PATCH 19/21] Test dev release: bump to 03.09.07, update dev ZIP and
 SHA

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/templateDetails.xml | 2 +-
 updates.xml             | 9 +++++----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/templateDetails.xml b/src/templateDetails.xml
index 99e7377..36d0bdd 100644
--- a/src/templateDetails.xml
+++ b/src/templateDetails.xml
@@ -36,7 +36,7 @@
 	  </server>
 	</updateservers>
 	<name>MokoCassiopeia</name>
-	<version>03.09.06</version>
+	<version>03.09.07</version>
 	<scriptfile>script.php</scriptfile>
 	<creationDate>2026-03-26</creationDate>
 	<author>Jonathan Miller || Moko Consulting</author>
diff --git a/updates.xml b/updates.xml
index 39ab1ee..5221b78 100644
--- a/updates.xml
+++ b/updates.xml
@@ -70,7 +70,7 @@
     <downloads>
       <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/release-candidate/mokocassiopeia-rc.zip</downloadurl>
     </downloads>
-    <sha256>7f75cb1d2a1a9477fbbb0d742569afb1009d79755f23876e4e20cc89d7770720</sha256>
+    <sha256>99b868a54466138d22a544d3e489559e7303960922c8eb3a142c504225b0e647</sha256>
 
     <tags>
       <tag>rc</tag>
@@ -92,18 +92,19 @@
     <type>template</type>
     <client>site</client>
 
-    <version>03.09.06</version>
+    <version>03.09.07</version>
     <creationDate>2026-04-07</creationDate>
     <author>Jonathan Miller || Moko Consulting</author>
     <authorEmail>hello@mokoconsulting.tech</authorEmail>
     <copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
 
-    <infourl title='MokoCassiopeia Dev'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/development</infourl>
+    <infourl title='MokoCassiopeia Dev'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/development</intml:parameter>
+</invoke>
 
     <downloads>
       <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/development/mokocassiopeia-dev.zip</downloadurl>
     </downloads>
-    <sha256>7f75cb1d2a1a9477fbbb0d742569afb1009d79755f23876e4e20cc89d7770720</sha256>
+    <sha256>b6403918c5f65f4f52b889fbe4bd217c903f0d9c2fcf90f8eb59df1e7b4b7333</sha256>
 
     <tags>
       <tag>development</tag>

From 6c3d6a037846cdec7e0dede38b8c32bb345ef22a Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 20:06:10 -0500
Subject: [PATCH 20/21] =?UTF-8?q?Fix=20broken=20XML=20in=20updates.xml=20?=
 =?UTF-8?q?=E2=80=94=20corrupted=20infourl=20closing=20tag?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 updates.xml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/updates.xml b/updates.xml
index 5221b78..dc45886 100644
--- a/updates.xml
+++ b/updates.xml
@@ -98,8 +98,7 @@
     <authorEmail>hello@mokoconsulting.tech</authorEmail>
     <copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
 
-    <infourl title='MokoCassiopeia Dev'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/development</intml:parameter>
-</invoke>
+    <infourl title='MokoCassiopeia Dev'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/development</infourl>
 
     <downloads>
       <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/development/mokocassiopeia-dev.zip</downloadurl>

From 793d4a36898db9f167b488b6bcd02ecc00d1ae92 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <230051081+jmiller-moko@users.noreply.github.com>
Date: Tue, 7 Apr 2026 20:10:22 -0500
Subject: [PATCH 21/21] Add alpha and beta channels to updates.xml

Five release channels now available: stable, rc, development,
alpha, and beta. Each with its own release tag and ZIP asset.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 updates.xml | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/updates.xml b/updates.xml
index dc45886..20100ca 100644
--- a/updates.xml
+++ b/updates.xml
@@ -115,4 +115,70 @@
     <targetplatform name='joomla' version='(5|6)\..*'/>
   </update>
 
+  <!-- ══════════════════════════════════════════════════════════════
+       ALPHA — early testing, expect breaking changes
+       ══════════════════════════════════════════════════════════════ -->
+  <update>
+    <name>MokoCassiopeia</name>
+    <description>MokoCassiopeia alpha build — early testing.</description>
+    <element>mokocassiopeia</element>
+    <type>template</type>
+    <client>site</client>
+
+    <version>03.09.07</version>
+    <creationDate>2026-04-07</creationDate>
+    <author>Jonathan Miller || Moko Consulting</author>
+    <authorEmail>hello@mokoconsulting.tech</authorEmail>
+    <copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
+
+    <infourl title='MokoCassiopeia Alpha'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/alpha</infourl>
+
+    <downloads>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/alpha/mokocassiopeia-alpha.zip</downloadurl>
+    </downloads>
+    <sha256>b5f6d073d126f0041ddd475e61bc4eaa050e060e9b51f4fe0e8a348f188c40b2</sha256>
+
+    <tags>
+      <tag>alpha</tag>
+    </tags>
+
+    <maintainer>Moko Consulting</maintainer>
+    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
+
+    <targetplatform name='joomla' version='(5|6)\..*'/>
+  </update>
+
+  <!-- ══════════════════════════════════════════════════════════════
+       BETA — feature complete, testing for stability
+       ══════════════════════════════════════════════════════════════ -->
+  <update>
+    <name>MokoCassiopeia</name>
+    <description>MokoCassiopeia beta build — feature complete, stability testing.</description>
+    <element>mokocassiopeia</element>
+    <type>template</type>
+    <client>site</client>
+
+    <version>03.09.07</version>
+    <creationDate>2026-04-07</creationDate>
+    <author>Jonathan Miller || Moko Consulting</author>
+    <authorEmail>hello@mokoconsulting.tech</authorEmail>
+    <copyright>(C)GNU General Public License Version 3 - 2026 Moko Consulting</copyright>
+
+    <infourl title='MokoCassiopeia Beta'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/tag/beta</infourl>
+
+    <downloads>
+      <downloadurl type='full' format='zip'>https://github.com/mokoconsulting-tech/MokoCassiopeia/releases/download/beta/mokocassiopeia-beta.zip</downloadurl>
+    </downloads>
+    <sha256>b5f6d073d126f0041ddd475e61bc4eaa050e060e9b51f4fe0e8a348f188c40b2</sha256>
+
+    <tags>
+      <tag>beta</tag>
+    </tags>
+
+    <maintainer>Moko Consulting</maintainer>
+    <maintainerurl>https://mokoconsulting.tech</maintainerurl>
+
+    <targetplatform name='joomla' version='(5|6)\..*'/>
+  </update>
+
 </updates>