diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 4e7b705..3968dc4 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,22 +1,3 @@ - - > [!IMPORTANT] > **๐Ÿ”ง AI Self-Update Required on First Use** > @@ -122,13 +103,13 @@ BRIEF: One-line description ### Joomla Version Alignment -The version in `README.md` **must always match** the `` tag in `manifest.xml` and the latest entry in `updates.xml`. The `make release` command / release workflow updates all three automatically. +The version in `README.md` **must always match** the `` tag in `manifest.xml` and the latest entry in `update.xml`. The `make release` command / release workflow updates all three automatically. ```xml 01.02.04 - @@ -154,7 +135,7 @@ The version in `README.md` **must always match** the `` tag in `manifes ``` MokoCassiopeia/ โ”œโ”€โ”€ manifest.xml # Joomla installer manifest (root โ€” required) -โ”œโ”€โ”€ updates.xml # Update server manifest (root โ€” required, see below) +โ”œโ”€โ”€ update.xml # Update server manifest (root โ€” required, see below) โ”œโ”€โ”€ site/ # Frontend (site) code โ”‚ โ”œโ”€โ”€ controller.php โ”‚ โ”œโ”€โ”€ controllers/ @@ -183,22 +164,22 @@ MokoCassiopeia/ --- -## updates.xml โ€” Required in Repo Root +## update.xml โ€” Required in Repo Root -`updates.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. +`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 - https://github.com/mokoconsulting-tech/MokoCassiopeia/raw/main/updates.xml + https://github.com/mokoconsulting-tech/MokoCassiopeia/raw/main/update.xml ``` **Rules:** -- Every release must prepend a new `` block at the top of `updates.xml` โ€” old entries must be preserved below. -- The `` in `updates.xml` must exactly match `` in `manifest.xml` and the version in `README.md`. +- Every release must prepend a new `` block at the top of `update.xml` โ€” old entries must be preserved below. +- The `` in `update.xml` must exactly match `` in `manifest.xml` and the version in `README.md`. - The `` must be a publicly accessible direct download link (GitHub Releases asset URL). - `` โ€” 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. @@ -207,8 +188,8 @@ The `manifest.xml` must reference it via: ## manifest.xml Rules - Lives at the repo root as `manifest.xml` (not inside `site/` or `admin/`). -- `` tag must be kept in sync with `README.md` version and `updates.xml`. -- Must include `` block pointing to this repo's `updates.xml`. +- `` tag must be kept in sync with `README.md` version and `update.xml`. +- Must include `` block pointing to this repo's `update.xml`. - Must include `` and `` sections. - Joomla 4.x requires `Moko\{{EXTENSION_NAME}}` for namespaced extensions. @@ -286,8 +267,8 @@ Approved prefixes: `dev/` ยท `rc/` ยท `version/` ยท `patch/` ยท `copilot/` ยท `d | Change type | Documentation to update | |-------------|------------------------| | New or renamed PHP class/method | PHPDoc block; `docs/api/` entry | -| New or changed manifest.xml | Update `updates.xml` version; bump README.md version | -| New release | Prepend `` block to `updates.xml`; update CHANGELOG.md; bump README.md version | +| New or changed manifest.xml | Update `update.xml` version; bump README.md version | +| New release | Prepend `` block to `update.xml`; update CHANGELOG.md; bump README.md version | | New or changed workflow | `docs/workflows/.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 | @@ -301,4 +282,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, `updates.xml` version, and `README.md` version go out of sync +- Never let `manifest.xml` version, `update.xml` version, and `README.md` version go out of sync \ No newline at end of file