chore: sync dev-tools assets and backfill changelog for framework

coisa · coisa · commit b53609cf2300 · 2026-04-24T21:26:10.000-03:00
diff --git a/.agents/agents/README.md b/.agents/agents/README.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/README.md
diff --git a/.agents/agents/agents-maintainer.md b/.agents/agents/agents-maintainer.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/agents-maintainer.md
diff --git a/.agents/agents/changelog-maintainer.md b/.agents/agents/changelog-maintainer.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/changelog-maintainer.md
diff --git a/.agents/agents/consumer-sync-auditor.md b/.agents/agents/consumer-sync-auditor.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/consumer-sync-auditor.md
diff --git a/.agents/agents/docs-writer.md b/.agents/agents/docs-writer.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/docs-writer.md
diff --git a/.agents/agents/issue-editor.md b/.agents/agents/issue-editor.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/issue-editor.md
diff --git a/.agents/agents/issue-implementer.md b/.agents/agents/issue-implementer.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/issue-implementer.md
diff --git a/.agents/agents/php-style-curator.md b/.agents/agents/php-style-curator.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/php-style-curator.md
diff --git a/.agents/agents/quality-pipeline-auditor.md b/.agents/agents/quality-pipeline-auditor.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/quality-pipeline-auditor.md
diff --git a/.agents/agents/readme-maintainer.md b/.agents/agents/readme-maintainer.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/readme-maintainer.md
diff --git a/.agents/agents/review-guardian.md b/.agents/agents/review-guardian.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/review-guardian.md
diff --git a/.agents/agents/test-guardian.md b/.agents/agents/test-guardian.md
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/test-guardian.md
diff --git a/.agents/skills/changelog-generator b/.agents/skills/changelog-generator
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/changelog-generator/
diff --git a/.agents/skills/create-agentsmd b/.agents/skills/create-agentsmd
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/create-agentsmd/
diff --git a/.agents/skills/github-issues b/.agents/skills/github-issues
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/github-issues/
diff --git a/.agents/skills/github-pull-request b/.agents/skills/github-pull-request
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/github-pull-request/
diff --git a/.agents/skills/package-readme b/.agents/skills/package-readme
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/package-readme/
diff --git a/.agents/skills/phpdoc-code-style b/.agents/skills/phpdoc-code-style
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/phpdoc-code-style/
diff --git a/.agents/skills/phpunit-tests b/.agents/skills/phpunit-tests
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/phpunit-tests/
diff --git a/.agents/skills/pull-request-review b/.agents/skills/pull-request-review
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/pull-request-review/
diff --git a/.agents/skills/sphinx-docs b/.agents/skills/sphinx-docs
@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/sphinx-docs/
diff --git a/.gitattributes b/.gitattributes
@@ -1,13 +1,16 @@
-*                   text=auto
-/.github/           export-ignore
-/tests/             export-ignore
-/.docheader         export-ignore
-/.dockerignore      export-ignore
-/.editorconfig      export-ignore
-/.gitattributes     export-ignore
-/.gitignore         export-ignore
-/.php-cs-fixer.php  export-ignore
-/docker-compose     export-ignore
-/Dockerfile         export-ignore
-/infection.json5    export-ignore
-/phpunit.xml        export-ignore
+*                  text=auto
+/.github/          export-ignore
+/docs/             export-ignore
+/tests/            export-ignore
+/.docheader        export-ignore
+/.dockerignore     export-ignore
+/.editorconfig     export-ignore
+/.gitattributes    export-ignore
+/.gitignore        export-ignore
+/.gitmodules       export-ignore
+/.php-cs-fixer.php export-ignore
+/docker-compose    export-ignore
+/Dockerfile        export-ignore
+/infection.json5   export-ignore
+/phpunit.xml       export-ignore
+/README.md         export-ignore
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
@@ -0,0 +1,12 @@
+# Generated by fast-forward/dev-tools
+#
+# Review the generated owners before committing this file.
+#
+# When no GitHub owners can be inferred automatically, replace the placeholder
+# example below with the usernames, teams, or emails that should review
+# changes in the consumer repository.
+#
+# Example:
+# * @your-github-user @your-org/platform-team
+
+* @php-fast-forward
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
@@ -1,3 +1,3 @@
 github: php-fast-forward
 custom:
-  - https://www.paypal.com/donate/?business=JLDAF45XZ8D84
+  - 'https://www.paypal.com/donate/?business=JLDAF45XZ8D84'
diff --git a/.github/workflows/auto-assign.yml b/.github/workflows/auto-assign.yml
@@ -0,0 +1,22 @@
+name: Auto assign
+
+on:
+  pull_request_target:
+    types: [opened, reopened, synchronize]
+  issues:
+    types: [opened, reopened]
+
+jobs:
+  auto-assign:
+    permissions:
+      issues: write
+      repository-projects: write
+      pull-requests: write
+    uses: php-fast-forward/dev-tools/.github/workflows/auto-assign.yml@main
+    with:
+      # project: 1
+      #
+      # Consumer repositories SHOULD set this to the target GitHub Project V2
+      # number. Repositories inside php-fast-forward MAY omit it and let the
+      # reusable workflow default to the first organization project.
+      project: ${{ vars.PROJECT || '' }}
diff --git a/.github/workflows/auto-resolve-conflicts.yml b/.github/workflows/auto-resolve-conflicts.yml
@@ -0,0 +1,36 @@
+name: "Fast Forward Predictable Conflict Resolution"
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - ready_for_review
+  workflow_dispatch:
+    inputs:
+      base-ref:
+        description: Base branch inspected for open pull requests.
+        required: false
+        type: string
+        default: main
+      pull-request-number:
+        description: Optional pull request number to inspect. Leave empty to scan open pull requests targeting the base branch.
+        required: false
+        type: string
+        default: ''
+
+permissions:
+  actions: write
+  contents: write
+  pull-requests: write
+
+jobs:
+  auto-resolve-conflicts:
+    uses: php-fast-forward/dev-tools/.github/workflows/auto-resolve-conflicts.yml@main
+    with:
+      base-ref: ${{ inputs.base-ref || github.event.pull_request.base.ref || github.event.repository.default_branch || 'main' }}
+      pull-request-number: ${{ inputs.pull-request-number || github.event.pull_request.number || '' }}
+    secrets: inherit
diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
@@ -0,0 +1,49 @@
+name: "Fast Forward Changelog"
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize]
+  pull_request_target:
+    types: [closed]
+  workflow_dispatch:
+    inputs:
+      changelog-file:
+        description: Path to the managed changelog file.
+        required: false
+        type: string
+        default: CHANGELOG.md
+      project:
+        description: Optional GitHub Project V2 number used for project-board release transitions.
+        required: false
+        type: string
+        default: ''
+      version:
+        description: Optional version to promote. Leave empty to infer from Unreleased.
+        required: false
+        type: string
+        default: ''
+      release-branch-prefix:
+        description: Prefix used for release-preparation branches.
+        required: false
+        type: string
+        default: release/v
+
+permissions:
+  actions: write
+  contents: write
+  pull-requests: write
+  repository-projects: write
+
+jobs:
+  changelog:
+    uses: php-fast-forward/dev-tools/.github/workflows/changelog.yml@main
+    with:
+      changelog-file: ${{ inputs.changelog-file || 'CHANGELOG.md' }}
+      # project: 1
+      #
+      # Consumer repositories SHOULD set this when they want changelog-driven
+      # release transitions to update a specific GitHub Project V2 board.
+      project: ${{ inputs.project || vars.PROJECT || '' }}
+      version: ${{ inputs.version || '' }}
+      release-branch-prefix: ${{ inputs.release-branch-prefix || 'release/v' }}
+    secrets: inherit
diff --git a/.github/workflows/label-sync.yml b/.github/workflows/label-sync.yml
@@ -0,0 +1,15 @@
+name: Label sync
+
+on:
+  pull_request_target:
+    types: [opened, reopened, synchronize]
+  issues:
+    types: [opened, reopened]
+
+jobs:
+  label-sync:
+    permissions:
+      contents: read
+      issues: read
+      pull-requests: write
+    uses: php-fast-forward/dev-tools/.github/workflows/label-sync.yml@main
diff --git a/.github/workflows/reports.yml b/.github/workflows/reports.yml
@@ -1,17 +1,28 @@
 name: "Fast Forward Reports"
 
 on:
+  pull_request:
+    types: [opened, synchronize, reopened, closed]
   push:
     branches:
       - main
+  schedule:
+    - cron: '41 3 * * *'
   workflow_dispatch:
+    inputs:
+      cleanup-previews:
+        description: Remove stale pull request previews without publishing production reports.
+        required: false
+        type: boolean
+        default: false
 
 permissions:
   contents: write
-  pages: write
-  id-token: write
+  pull-requests: write
 
 jobs:
   reports:
     uses: php-fast-forward/dev-tools/.github/workflows/reports.yml@main
     secrets: inherit
+    with:
+      cleanup-previews: ${{ inputs.cleanup-previews || false }}
diff --git a/.github/workflows/review.yml b/.github/workflows/review.yml
@@ -0,0 +1,20 @@
+name: Rigorous Pull Request Review
+
+on:
+  pull_request_target:
+    types: [ready_for_review]
+  workflow_dispatch:
+    inputs:
+      pull-request-number:
+        description: Pull request number to review manually.
+        required: true
+        type: string
+
+jobs:
+  rigorous-review:
+    permissions:
+      contents: read
+      pull-requests: write
+    uses: php-fast-forward/dev-tools/.github/workflows/review.yml@main
+    with:
+      pull-request-number: ${{ github.event.pull_request.number || inputs.pull-request-number || '' }}
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -2,14 +2,32 @@ name: "Fast Forward Test Suite"
 
 on:
   push:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
   workflow_dispatch:
+    inputs:
+      max-outdated:
+        description: Maximum number of outdated packages allowed by the dependencies command.
+        required: false
+        type: string
+        default: '-1'
+      publish-required-statuses:
+        description: Mirror required test matrix checks as commit statuses for workflow-dispatched runs.
+        required: false
+        type: boolean
+        default: false
 
 permissions:
-  contents: write
-  pages: write
-  id-token: write
+  contents: read
+  statuses: write
 
 jobs:
   tests:
     uses: php-fast-forward/dev-tools/.github/workflows/tests.yml@main
+    with:
+      max-outdated: ${{ inputs.max-outdated || -1 }}
+      publish-required-statuses: ${{ inputs.publish-required-statuses || false }}
     secrets: inherit
diff --git a/.github/workflows/wiki-maintenance.yml b/.github/workflows/wiki-maintenance.yml
@@ -0,0 +1,26 @@
+name: "Fast Forward Wiki Maintenance"
+
+on:
+  pull_request_target:
+    types: [closed]
+  schedule:
+    - cron: '17 3 * * *'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: read
+
+concurrency:
+  group: fast-forward-wiki-maintenance-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  maintenance:
+    permissions:
+      contents: write
+      pull-requests: read
+    # This wrapper handles merged publication to the wiki master branch plus
+    # preview-branch cleanup. Pull-request preview generation lives in wiki.yml.
+    uses: php-fast-forward/dev-tools/.github/workflows/wiki-maintenance.yml@main
+    secrets: inherit
diff --git a/.github/workflows/wiki.yml b/.github/workflows/wiki.yml
@@ -1,17 +1,25 @@
 name: "Fast Forward Wiki Update"
 
 on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
+  pull_request:
+    types: [opened, synchronize, reopened]
 
 permissions:
+  actions: write
   contents: write
-  pages: write
-  id-token: write
+  pull-requests: read
+
+concurrency:
+  group: fast-forward-wiki-preview-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
 
 jobs:
-  wiki:
-    uses: php-fast-forward/dev-tools/.github/workflows/wiki.yml@main
+  preview:
+    permissions:
+      actions: write
+      contents: write
+      pull-requests: read
+    # Pull-request wiki previews live here. Publication and preview cleanup are
+    # handled by the separate wiki-maintenance wrapper.
+    uses: php-fast-forward/dev-tools/.github/workflows/wiki-preview.yml@main
     secrets: inherit
diff --git a/.gitignore b/.gitignore
@@ -1,7 +1,10 @@
+.dev-tools/
 .idea/
 .vscode/
+backup/
 public/
 tmp/
 vendor/
-composer.lock
 *.cache
+.DS_Store
+composer.lock
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/LICENSE b/LICENSE
diff --git a/composer.json b/composer.json

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+../../vendor/fast-forward/dev-tools/.agents/agents/README.md`