6.x

.agents/skills/changelog-entries/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: changelog-entries
+description: >
+  Write changelog entries for CHANGELOG.md. Use when work has been completed
+  and changelog entries need to be added, or when the user asks to write, add, or update changelog
+  entries, release notes, or document changes. Triggers on requests like "add changelog entry",
+  "update the changelog", "write release notes", or after completing a feature/fix that needs documenting.
+---
+
+# Changelog Entries
+
+Write entries that match the established format in the target changelog file.
+
+## Determine Target File
+
+1. If the user specifies a file, use that, otherwise use `CHANGELOG.md`.
+2. Read the first ~80 lines of the target file to confirm the current format and find the insertion point.
+
+## CHANGELOG.md Format
+
+Versioned release changelog. Entries go under `## Unreleased` or a version header like `## X.Y.Z - YYYY-MM-DD`.
+
+Each entry is a `- ` prefixed line. No blank lines between entries within a section.
+
+```markdown
+## Unreleased
+
+- Added `craft\helpers\SomeHelper::someMethod()`.
+- Fixed a bug where something wasn't working properly. ([#12345](https://github.com/craftcms/cms/pull/12345))
+- Deprecated `craft\old\Thing`. `craft\new\Thing` should be used instead.
+```
+
+**Patch releases** use a flat list with no subheaders.
+
+**Major/minor releases** may group entries under `###` subheaders:
+`### Content Management`, `### Accessibility`, `### Administration`, `### Development`, `### Extensibility`, `### System`
+
+**Warnings** go above the entry list using GitHub callout syntax:
+```markdown
+> [!WARNING]
+> Important note about breaking changes.
+```
+
+## Writing Rules
+
+1. **Start with a past-tense verb** — capitalize it:
+   - `Added` — new classes, methods, features, settings
+   - `Fixed` — bug fixes: `Fixed a bug where...` or `Fixed an error that...`
+   - `Deprecated` — include replacement: `` `old\Thing`. `new\Thing` should be used instead. ``
+   - `Removed` — removed classes/features (with replacement if applicable)
+   - `Improved` — performance or UX improvements
+   - Other verbs as appropriate: `Updated`, `Renamed`, `Moved`, `Replaced`
+
+2. **Backtick all code references** — class names, methods, properties, constants, config keys, Twig variables, CLI commands. Use fully qualified class names (no leading backslash).
+
+3. **One entry per line** — don't wrap. Each `- ` entry is a single line regardless of length.
+
+4. **End entries with a period.**
+
+5. **Link issues/PRs** at the end when applicable, prefer PRs when there is one:
+   - PRs: `([#12345](https://github.com/craftcms/cms/pull/12345))`
+   - Issues: `([#12345](https://github.com/craftcms/cms/issues/12345))`
+   - Security: `(GHSA-xxxx-xxxx-xxxx)`
+   - External repos: `([craftcms/commerce#4006](https://github.com/craftcms/commerce/issues/4006))`
+
+6. **Security fixes** include severity level: `` Fixed a [high-severity](https://github.com/craftcms/cms/security/policy#severity--remediation) RCE vulnerability. (GHSA-xxxx-xxxx-xxxx) ``
+
+7. **Keyboard shortcuts** use `<kbd>` tags: `<kbd>Return</kbd>`.
+
+## Entry Templates
+
+For the full set of templates and examples, see `references/entry-templates.md`.
+
+## Workflow
+
+1. Identify what changed (from conversation context, git diff, or user description).
+2. Determine the target file and section/insertion point.
+3. Write entries following the format rules above.
+4. Insert entries in the appropriate location in the file.

.agents/skills/changelog-entries/references/entry-templates.md

@@ -0,0 +1,225 @@
+# Entry Templates
+
+## Added
+
+**New class or service:**
+```
+- Added `CraftCms\Cms\Namespace\ClassName`.
+```
+
+**New facade:**
+```
+- Added `CraftCms\Cms\Support\Facades\FacadeName`.
+```
+
+**New enum:**
+```
+- Added `CraftCms\Cms\Namespace\EnumName` enum.
+```
+
+**New event:**
+```
+- Added `CraftCms\Cms\Namespace\Events\EventName`.
+```
+
+**New event with description:**
+```
+- Added `CraftCms\Cms\Namespace\Events\EventName` event for customizing X behavior.
+```
+
+**New method or property:**
+```
+- Added `craft\helpers\ElementHelper::cleanseQueryCriteria()`.
+- Added `craft\base\ElementTrait::$applyingDraft`. ([#18057](https://github.com/craftcms/cms/pull/18057))
+```
+
+**New method macro:**
+```
+- Added `Request::isPreview()` macro for detecting preview requests via `x-craft-preview` or `x-craft-live-preview` parameters.
+```
+
+**New console command:**
+```
+- Added `php craft twig:cache` - Precompile Twig views.
+```
+
+**New config setting:**
+```
+- Added the `enableTwigSandbox` config setting. ([#18208](https://github.com/craftcms/cms/pull/18208))
+```
+
+**New library:**
+```
+- Added the Illuminate Support library.
+```
+
+**Multiple related additions (with sub-list):**
+```
+- Added element-specific authorization policies:
+  - `CraftCms\Cms\Entry\Policies\EntryPolicy`
+  - `CraftCms\Cms\Asset\Policies\AssetPolicy`
+```
+
+## Fixed
+
+**Bug fix:**
+```
+- Fixed a bug where something wasn't working properly. ([#12345](https://github.com/craftcms/cms/pull/12345))
+- Fixed a bug where Matrix fields in Blocks view could lose their existing values when they became editable.
+```
+
+**Error fix:**
+```
+- Fixed an error that could occur when editing an element with a Table field. ([#18408](https://github.com/craftcms/cms/pull/18408))
+- Fixed an error that occurred when creating a new element on multi-site installs. ([#18393](https://github.com/craftcms/cms/pull/18393))
+```
+
+**JavaScript fix:**
+```
+- Fixed a JavaScript error that occurred if a Matrix field's label was hidden. ([#18366](https://github.com/craftcms/cms/pull/18366))
+- Fixed potential JavaScript errors that could occur if a disclosure menu's trigger was missing. ([#18358](https://github.com/craftcms/cms/pull/18358))
+```
+
+**Security fix:**
+```
+- Fixed a [high-severity](https://github.com/craftcms/cms/security/policy#severity--remediation) RCE vulnerability. (GHSA-fp5j-j7j4-mcxc)
+- Fixed a [moderate-severity](https://github.com/craftcms/cms/security/policy#severity--remediation) SSTI vulnerability. (GHSA-qc86-q28f-ggww)
+- Fixed [low-severity](https://github.com/craftcms/cms/security/policy#severity--remediation) XSS vulnerabilities. (GHSA-4mgv-366x-qxvx)
+```
+
+**Styling fix:**
+```
+- Fixed a styling issue with slideouts within Live Preview. ([#18383](https://github.com/craftcms/cms/pull/18383))
+```
+
+## Deprecated
+
+**Class replaced by new class:**
+```
+- Deprecated `craft\old\ClassName`. `CraftCms\Cms\New\ClassName` should be used instead.
+```
+
+**Method replaced by new method:**
+```
+- Deprecated `craft\old\Class::oldMethod()`. `CraftCms\Cms\New\Class::newMethod()` should be used instead.
+```
+
+**Property replaced:**
+```
+- Deprecated `GeneralConfig::$oldProp` in favor of Laravel's config.key config value.
+```
+
+**Constant replaced by enum case:**
+```
+- Deprecated `craft\web\View::TEMPLATE_MODE_CP`. `CraftCms\Cms\View\TemplateMode::Cp` should be used instead.
+```
+
+**Event constant replaced by event class:**
+```
+- Deprecated `craft\web\View::EVENT_REGISTER_CP_TEMPLATE_ROOTS`. `CraftCms\Cms\View\Events\RegisterCpTemplateRoots` should be used instead.
+```
+
+**Twig variable replaced:**
+```
+- Deprecated `craft.app.config.general` in Twig. `app.config.craft.general` should be used instead.
+```
+
+**Class replaced with extra context:**
+```
+- Deprecated `Craft::$app->getConfig()->getGeneral()`. `CraftCms\Cms\Config\GeneralConfig` should be used instead. This can be used through dependency injection or through `app(CraftCms\Cms\Config\GeneralConfig::class)`.
+```
+
+**Config setting deprecated:**
+```
+- The `disableGraphqlTransformDirective` config setting is now deprecated.
+```
+
+**Replaced by Laravel built-in (no direct Craft replacement):**
+```
+- Deprecated `craft\filters\BasicHttpAuthLogin`. Use the `auth.basic` middleware instead.
+```
+
+**Multiple methods with "in favor of" and sub-list:**
+```
+- Deprecated `craft\events\WidgetEvent` in favor of the following new events:
+  - `craft\services\Dashboard::EVENT_BEFORE_SAVE_WIDGET` => `CraftCms\Cms\Dashboard\Events\WidgetSaving`
+  - `craft\services\Dashboard::EVENT_AFTER_SAVE_WIDGET` => `CraftCms\Cms\Dashboard\Events\WidgetSaved`
+```
+
+**Multiple methods from same class (sub-list with arrow mapping):**
+```
+- Deprecated `craft\helpers\App`. The following classes/methods should be used instead:
+  - `App:devMode()` --> `app()->hasDebugModeEnabled()`
+  - `App:parseBooleanEnv()` --> `\CraftCms\Cms\Support\Env::parseBoolean()`
+```
+
+## Removed
+
+**Class removed with replacement:**
+```
+- Removed `craft\old\Class`. `CraftCms\Cms\New\Class` should be used instead.
+```
+
+**Class removed with multiple replacements:**
+```
+- Removed `craft\controllers\DashboardController`. The following controllers now implement this functionality:
+  - `CraftCms\Cms\Http\Controllers\Dashboard\DashboardController`
+  - `CraftCms\Cms\Http\Controllers\Dashboard\WidgetsController`
+```
+
+**Removed because previously deprecated:**
+```
+- Removed `craft\helpers\MigrationHelper` as it was deprecated since 4.0.0.
+```
+
+**Event removed:**
+```
+- Removed `craft\events\UpdateReleaseEvent` in favor of `CraftCms\Cms\Update\Events\CriticalUpdateReleasedEvent`.
+```
+
+**Database column removed:**
+```
+- Removed `verificationCode` and `verificationCodeIssuedDate` columns on the `users` table in favor of the `password_reset_tokens` table.
+```
+
+## Replaced
+
+```
+- Replaced `craft\controllers\StructuresController`. `CraftCms\Cms\Http\Controllers\StructuresController`.
+- Replaced `craft\controllers\SystemMessagesController` with `CraftCms\Cms\Http\Controllers\Utilities\SystemMessagesController`.
+```
+
+## Improved
+
+```
+- Improved the performance of `craft\helpers\Typecast`. ([#18426](https://github.com/craftcms/cms/pull/18426))
+- Improved the accessibility of user permission lists. ([#18290](https://github.com/craftcms/cms/pull/18290))
+- Improved drag-n-drop performance. ([#18019](https://github.com/craftcms/cms/pull/18019))
+```
+
+## Updated
+
+```
+- Updated Yii to 2.0.54.
+- Updated Twig to 3.21. ([#17603](https://github.com/craftcms/cms/discussions/17603))
+- Updated Axios to 1.12.2. ([#17988](https://github.com/craftcms/cms/pull/17988))
+```
+
+## Behavioral Changes (no action verb prefix)
+
+```
+- `CraftCms\Cms\User\Elements\User` now implements `Illuminate\Contracts\Auth\Authenticatable`.
+- `craft\services\Elements::stopCollectingCacheInfo()` no longer sets the returned duration to the `cacheDuration` config setting if a duration wasn't explicitly declared. ([#16796](https://github.com/craftcms/cms/pull/16796))
+- Element indexes now show "Paste" buttons alongside bulk element action buttons. ([#18427](https://github.com/craftcms/cms/pull/18427))
+- `slug` columns referenced in element queries' `select`, `where`, or `orderBy` expressions now explicitly resolve to `elements_sites.slug`. ([#18416](https://github.com/craftcms/cms/pull/18416))
+- The `maxCachedCloudImageSize` config setting is now set to `0` by default. ([#17997](https://github.com/craftcms/cms/pull/17997))
+```
+
+## Feature Descriptions (no code reference)
+
+```
+- Nested entries' edit screens now have a "Field settings" action menu item.
+- Legacy entry index URLs now redirect `content/<page-name>`.
+- Bulk element actions are now available on element indexes for mobile devices.
+- Revisions now keep track of which element attributes/fields were modified for the revision.
+```

.github/actions/run-tests/action.yml

@@ -0,0 +1,60 @@
+name: 'Run Tests'
+description: 'Setup PHP, install dependencies, and run a test command'
+
+inputs:
+  test-command:
+    description: 'The test command to run'
+    required: true
+  php-version:
+    description: 'PHP version to install'
+    required: false
+    default: '8.5'
+  github-token:
+    description: 'GitHub token for Composer'
+    required: false
+    default: ''
+  packagist-username:
+    description: 'Packagist username'
+    required: false
+    default: ''
+  packagist-token:
+    description: 'Packagist token'
+    required: false
+    default: ''
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Setup PHP
+      uses: shivammathur/setup-php@v2
+      with:
+        php-version: ${{ inputs.php-version }}
+        extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, bcmath, soap, intl, gd, exif, iconv, imagick, fileinfo, ffi
+        tools: composer:v2
+        ini-values: display_errors=On, memory_limit=2G
+        coverage: none
+        # Pass an empty token so setup-php doesn't write GITHUB_TOKEN into
+        # Composer's auth config. Composer 2.9.7's regex rejects the new
+        # GITHUB_TOKEN format (composer/composer#12849).
+        github-token: ''
+      env:
+        COMPOSER_AUTH_JSON: |
+          {
+            "http-basic": {
+              "repo.packagist.com": {
+                "username": "${{ inputs.packagist-username }}",
+                "password": "${{ inputs.packagist-token }}"
+              }
+            }
+          }
+
+    - name: Set version
+      shell: bash
+      run: composer config version "6.x-dev"
+
+    - name: Install dependencies
+      uses: ramsey/composer-install@v3
+
+    - name: Run tests
+      shell: bash
+      run: ${{ inputs.test-command }}