Merge pull request #2 from php-n8n/ci-improvements

CI orchestration improvement

Author: saedyousef

.github/workflows/ci.yml

@@ -68,3 +68,21 @@ jobs:
           token: ${{ secrets.CODECOV_TOKEN }}
           slug: php-n8n/client
           fail_ci_if_error: true
+
+  dispatch-post-ci:
+    name: Dispatch post-CI build
+    runs-on: ubuntu-latest
+    needs:
+      - check
+      - coverage
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+
+    steps:
+      - name: Dispatch post-CI build workflow
+        uses: saedyousef/repository-dispatch@v0.2
+        with:
+          token: ${{ secrets.REPOSITORY_DISPATCH_TOKEN }}
+          owner: ${{ github.repository_owner }}
+          repo: ${{ github.event.repository.name }}
+          event_type: client-ci-passed
+          client_payload: '{"sha":"${{ github.sha }}","ref":"${{ github.ref_name }}","run_id":"${{ github.run_id }}","run_url":"${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"}'

.github/workflows/post-ci-build.yml

@@ -0,0 +1,42 @@
+name: Post-CI Build
+
+on:
+  repository_dispatch:
+    types:
+      - client-ci-passed
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build Composer archive
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout dispatched commit
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.client_payload.sha }}
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          coverage: none
+          tools: composer:v2
+
+      - name: Validate package metadata
+        run: composer validate --strict
+
+      - name: Build Composer archive
+        run: |
+          mkdir -p dist
+          composer archive --format=zip --file="dist/php-n8n-client-${{ github.event.client_payload.sha }}"
+
+      - name: Upload package archive
+        uses: actions/upload-artifact@v4
+        with:
+          name: php-n8n-client-${{ github.event.client_payload.sha }}
+          path: dist/*.zip
+          if-no-files-found: error

CHANGELOG.md

@@ -7,7 +7,12 @@ https://php-n8n.com
 
 This project follows [Semantic Versioning](https://semver.org/).
 
-## v1.0.0 - Unreleased
+## v1.0.1 - Unreleased
+
+- Added post-CI repository dispatch automation using `saedyousef/repository-dispatch`.
+- Added a repository-dispatch receiver workflow that builds and uploads a Composer package archive after CI passes.
+
+## v1.0.0 - 2026-05-10
 
 - Added webhook triggering through `$client->webhooks()->trigger()`.
 - Added execution fetching and polling through the n8n API.
@@ -18,6 +23,4 @@ This project follows [Semantic Versioning](https://semver.org/).
 
 ## Release Notes
 
-The first tagged release is expected to be `v1.0.0`.
-
-This release establishes the initial stable public API. Future breaking changes will be reserved for major releases.
+`v1.0.0` establishes the initial stable public API. Future breaking changes will be reserved for major releases.

CONTRIBUTING.md

@@ -38,6 +38,12 @@ composer check
 
 This runs Composer validation, PHPUnit, PSR-12 checks, and PHPStan.
 
+## CI/CD
+
+CI runs on pushes and pull requests. After the full CI and coverage jobs pass on `main`, the workflow dispatches the `client-ci-passed` repository event using `saedyousef/repository-dispatch`.
+
+The dispatch job requires a `REPOSITORY_DISPATCH_TOKEN` secret with repository access. The receiver workflow listens for `client-ci-passed`, checks out the tested commit, validates Composer metadata, builds a Composer archive, and uploads it as a workflow artifact.
+
 ## Pull Requests
 
 When contributing code:

README.md

@@ -171,7 +171,7 @@ composer check
 
 This package follows Semantic Versioning.
 
-The first public tag is expected to be `v1.0.0`, marking the client API as stable from the initial release.
+The first public tag, `v1.0.0`, marks the client API as stable from the initial release.
 
 Breaking changes will only be introduced in future major releases.