[github] Sync dev-tools assets and backfill release changelog (#1)

.agents/agents/README.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/README.md

.agents/agents/agents-maintainer.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/agents-maintainer.md

.agents/agents/changelog-maintainer.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/changelog-maintainer.md

.agents/agents/consumer-sync-auditor.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/consumer-sync-auditor.md

.agents/agents/docs-writer.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/docs-writer.md

.agents/agents/issue-editor.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/issue-editor.md

.agents/agents/issue-implementer.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/issue-implementer.md

.agents/agents/php-style-curator.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/php-style-curator.md

.agents/agents/quality-pipeline-auditor.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/quality-pipeline-auditor.md

.agents/agents/readme-maintainer.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/readme-maintainer.md

.agents/agents/review-guardian.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/review-guardian.md

.agents/agents/test-guardian.md

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/agents/test-guardian.md

.agents/skills/changelog-generator

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/changelog-generator/

.agents/skills/create-agentsmd

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/create-agentsmd/

.agents/skills/github-issues

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/github-issues/

.agents/skills/github-pull-request

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/github-pull-request/

.agents/skills/package-readme

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/package-readme/

.agents/skills/phpdoc-code-style

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/phpdoc-code-style/

.agents/skills/phpunit-tests

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/phpunit-tests/

.agents/skills/pull-request-review

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/pull-request-review/

.agents/skills/sphinx-docs

@@ -0,0 +1 @@
+../../vendor/fast-forward/dev-tools/.agents/skills/sphinx-docs/

.docheader

@@ -1,13 +1,13 @@
 /**
- * This file is part of php-fast-forward/framework.
+ * Fast Forward Framework — a lightweight PHP framework for building modern web applications with a simple and elegant API.
  *
- * This source file is subject to the license bundled
- * with this source code in the file LICENSE.
+ * This file is part of fast-forward/framework project.
  *
- * @copyright Copyright (c) 2025-%year% Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
- * @license   https://opensource.org/licenses/MIT MIT License
+ * @author   Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
+ * @license  https://opensource.org/licenses/MIT MIT License
  *
- * @see       https://github.com/php-fast-forward/framework
- * @see       https://github.com/php-fast-forward
- * @see       https://datatracker.ietf.org/doc/html/rfc2119
+ * @see      https://php-fast-forward.github.io/framework/
+ * @see      https://github.com/php-fast-forward/framework
+ * @see      https://github.com/php-fast-forward/framework/issues
+ * @see      https://datatracker.ietf.org/doc/html/rfc2119
  */

.gitattributes

@@ -1,13 +1,17 @@
-*                   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
+/.dev-tools/       export-ignore
+/.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

.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 @coisa

.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'

.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 || '' }}

.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

.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

.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

.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 }}

.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 || '' }}

.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

.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