Add auto-generated state-event model and SVG diagram with GitHub Page… (#6332)

* Add auto-generated state-event model and SVG diagram with GitHub Pages publishing

Introduces scripts to parse CCD definition JSON files into a structured
state-event model, enrich it with resolved state transitions from Java
handlers and BPMN workflows, and generate an SVG diagram. Includes a
GitHub Actions workflow to publish the SVG and model JSON to GitHub Pages
on push to master and weekly on Monday mornings.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Fix ESLint no-unused-vars errors in state-event scripts

Remove unused variables: trunc, SEP_H, wcStart, extraH, envelopeX,
envelopeY, ev (loop var), dir, and handlerPkg.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Exclude state-event scripts from SonarQube analysis

These are build/documentation utility scripts, not application code.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Move workflow permissions to job level for least-privilege security

Build job only needs contents:read. Deploy job already had its own
pages:write and id-token:write scoped at job level.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* DTSCCI-4116: Publish pages in github

* Add pull_request and workflow_dispatch triggers to state-event workflow

Enables the workflow to run on PRs (build only, no deploy) and to be
triggered manually. Also adds main branch alongside master.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Allow GitHub Pages deployment from PR branches

Removes the pull_request guard on deploy-pages so the state-event
model can be previewed before merging.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Restrict Pages deploy to non-PR events, add downloadable artifacts

PR branches cannot deploy to the github-pages environment due to
protection rules. The deploy step is now guarded. A separate
upload-artifact step provides downloadable SVG/JSON from any PR run.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: ruban72

.github/workflows/publish-state-event-model.yml

@@ -0,0 +1,97 @@
+name: Publish State-Event Model to GitHub Pages
+
+on:
+  workflow_dispatch:
+  pull_request:
+    branches:
+      - master
+      - main
+  push:
+    branches:
+      - master
+      - main
+  schedule:
+    - cron: '0 6 * * 1'  # Every Monday at 6am UTC — catches changes in civil-service / civil-camunda-bpmn-definition
+
+jobs:
+  build-state-event-model:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          path: civil-ccd-definition
+
+      - name: Checkout civil-service
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          repository: hmcts/civil-service
+          path: civil-service
+
+      - name: Checkout civil-camunda-bpmn-definition
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          repository: hmcts/civil-camunda-bpmn-definition
+          path: civil-camunda-bpmn-definition
+
+      - name: Use Node.js 24
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
+        with:
+          node-version: 24
+
+      - name: Install dependencies
+        working-directory: civil-ccd-definition
+        env:
+          YARN_ENABLE_SCRIPTS: "false"
+        run: yarn install --frozen-lockfile
+
+      - name: Generate state-event model
+        working-directory: civil-ccd-definition
+        run: yarn generate:state-event-model
+
+      - name: Enrich model with resolved state transitions
+        working-directory: civil-ccd-definition
+        run: >
+          node bin/utils/enrich-state-event-model.js
+          build/state-event-model.json
+          ../civil-service
+          ../civil-camunda-bpmn-definition
+
+      - name: Generate state-event SVG diagram
+        working-directory: civil-ccd-definition
+        run: node bin/utils/generate-state-event-svg.js ../civil-service
+
+      - name: Prepare output
+        run: |
+          mkdir -p pages
+          cp civil-ccd-definition/build/state-event-model.svg pages/state-event-model.svg
+          cp civil-ccd-definition/build/state-event-model.json pages/state-event-model.json
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: state-event-model
+          path: pages/
+
+      - name: Upload Pages artifact
+        if: github.event_name != 'pull_request'
+        uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3
+        with:
+          path: pages
+
+  deploy-pages:
+    if: github.event_name != 'pull_request'
+    needs: build-state-event-model
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac2227cb83f # v4