Skip to content

Require PHP 8.4 + Laravel 12, add AGENTS.md and real README#13

Merged
marianogoldman merged 6 commits into
masterfrom
docs/add-agents-and-readme
Jun 21, 2026
Merged

Require PHP 8.4 + Laravel 12, add AGENTS.md and real README#13
marianogoldman merged 6 commits into
masterfrom
docs/add-agents-and-readme

Conversation

@marianogoldman

@marianogoldman marianogoldman commented Jun 13, 2026

Copy link
Copy Markdown
Contributor

What

  1. Require PHP 8.4+ and upgrade to Laravel 12 (breaking change for consumers).
  2. Modernize the GitHub Actions workflow (it was failing on the disabled actions/cache@v2).
  3. Add AGENTS.md with guidance for AI coding agents.
  4. Rewrite README.md (was the Laravel Package Boilerplate template) with real content.

Dependency bump

  • php ^8.0>=8.4
  • illuminate/support ^8.0^12.0
  • puntodev/mercadopago ^2.0^6.0 (v6 itself requires PHP >=8.4 and Laravel 12)
  • dev: orchestra/testbench ^10.0, phpunit ^11.0, nunomaduro/collision ^8.0
  • composer.lock regenerated

Code/test changes required by the upgrade

  • Models — replaced the removed $dates property with a 'paid_on' => 'datetime' cast on Order/Payment.
  • Factories — added : array return type to definition().
  • Tests — made data providers static, migrated @test/@dataProvider doc annotations to PHPUnit attributes, removed a stray in-body @test comment.
  • phpunit.xml.dist — migrated to the PHPUnit 11 schema (<source>/<coverage>), dropped the removed Collision printerClass.

CI

  • actions/checkout@v2@v4, actions/cache@v2@v4
  • pinned PHP via shivammathur/setup-php@v2 (8.4)
  • dropped the removed Composer --no-suggest flag

Verification

vendor/bin/phpunit locally on PHP 8.4.22: 37 tests, 89 assertions, OK, no deprecations. CI green.

🤖 Generated with Claude Code

Document the package for both AI coding agents (AGENTS.md) and human
consumers (README.md): the gateway-agnostic payments abstraction, core
contracts, models, traits, payment flow, configuration and testing.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
@marianogoldman marianogoldman marked this pull request as ready for review June 13, 2026 13:47
marianogoldman and others added 2 commits June 13, 2026 10:48
actions/cache@v2 was disabled by GitHub, failing the build. Bump
checkout and cache to v4, pin PHP to 8.1 via setup-php, and drop the
removed Composer --no-suggest flag.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Bump the minimum PHP to >=8.4 and modernize the dependency tree so CI
runs on a supported stack:

- illuminate/support ^12.0, puntodev/mercadopago ^6.0
- dev: orchestra/testbench ^10.0, phpunit ^11.0, collision ^8.0
- regenerate composer.lock

Code/test changes required by the upgrade:
- Models: replace removed $dates property with 'paid_on' => 'datetime' cast
- Factories: add : array return type to definition()
- Tests: make data providers static, migrate @test/@dataProvider
  annotations to PHPUnit attributes, drop a stray in-body @test comment
- phpunit.xml.dist: migrate to the PHPUnit 11 schema (source/coverage),
  drop the removed Collision printerClass
- CI: pin setup-php to 8.4
- Docs: update AGENTS.md/README requirements

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
@marianogoldman marianogoldman changed the title Add AGENTS.md and rewrite README Require PHP 8.4 + Laravel 12, add AGENTS.md and real README Jun 13, 2026
marianogoldman and others added 3 commits June 13, 2026 11:00
Mirror the bookables setup:
- Rewrite CHANGELOG.md in Keep a Changelog format with an Unreleased
  section and a note about the automation.
- Add .github/release.yml to group generated release notes by PR label.
- Add .github/workflows/update-changelog.yml: on a published release,
  write its notes into CHANGELOG.md and commit back to master.

Requires a RELEASE_TOKEN secret (admin PAT) and enforce_admins disabled
on master so the changelog commit can be pushed to the protected branch.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Bump phpunit/phpunit from ^11.0 to ^12.0 (resolves to 12.5). Test suite
passes unchanged on PHP 8.4.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Match the bookables CI: run the suite on a PHP 8.4/8.5 matrix
(fail-fast off), name each job "PHP <version>" so the checks can be
required by branch protection, bump checkout to v5, install the common
extensions and enable pcov coverage.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
@marianogoldman marianogoldman merged commit 2e881c9 into master Jun 21, 2026
2 checks passed
@marianogoldman marianogoldman deleted the docs/add-agents-and-readme branch June 21, 2026 11:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant