showcase_build.yml

name: "Showcase: Build & Push"

# Decoupled from the old "Build & Deploy" workflow. This workflow builds
# Docker images, pushes them to GHCR, and triggers Railway to redeploy.
# The separate "Showcase: Verify Deploy" workflow (showcase_deploy.yml)
# handles health verification.
#
# Critical design property: NO concurrency group with cancel-in-progress.
# Every push to main runs to completion so that rapid-fire PR merges never
# cancel in-flight builds. This was the #1 operational pain point with the
# old combined workflow.

on:
  push:
    branches: [main]
    paths:
      - "showcase/**"
      - "examples/integrations/**"
      - ".github/workflows/showcase_build.yml"
      - ".github/workflows/showcase_build_check.yml"
  workflow_dispatch:
    inputs:
      service:
        description: "Service to build"
        required: false
        default: "all"
        type: choice
        options:
          - all
          - shell
          - langgraph-python
          - mastra
          - crewai-crews
          - pydantic-ai
          - google-adk
          - ag2
          - agno
          - llamaindex
          - langgraph-fastapi
          - langgraph-typescript
          - langroid
          - spring-ai
          - strands
          - ms-agent-python
          - claude-sdk-typescript
          - ms-agent-dotnet
          - ms-agent-harness-dotnet
          - claude-sdk-python
          - built-in-agent
          - shell-dojo
          - shell-dashboard
          - shell-docs
          - showcase-harness
          - showcase-aimock
          - showcase-pocketbase
          - webhooks
          # Per-starter image builds (model B, §b stage 1). These map to the
          # build-starters job below, NOT the showcase `build` job. "all"
          # builds the full showcase fleet AND all 12 starters; a specific
          # starter slug narrows to that one starter via STARTER_DISPATCH.
          - starter-langgraph-python
          - starter-mastra
          - starter-langgraph-js
          - starter-crewai-crews
          - starter-pydantic-ai
          - starter-adk
          - starter-agno
          - starter-llamaindex
          - starter-langgraph-fastapi
          - starter-strands-python
          - starter-ms-agent-framework-python
          - starter-ms-agent-framework-dotnet

# No top-level concurrency group. Every build run completes. This is the
# whole point of the decoupling: rapid pushes to main no longer cancel
# in-flight builds.

# Top-level env intentionally empty: env IDs are resolved inside
# showcase/scripts/redeploy-env.ts from the showcase/scripts/railway-envs.ts
# SSOT (and its emitted railway-envs.generated.json), not by this workflow.

permissions:
  contents: read

jobs:
  detect-changes:
    runs-on: ubuntu-latest
    timeout-minutes: 5
    permissions:
      contents: read
    outputs:
      matrix: ${{ steps.build-matrix.outputs.matrix }}
      has_changes: ${{ steps.build-matrix.outputs.has_changes }}
    steps:
      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          persist-credentials: false

      - name: Detect changed paths
        uses: dorny/paths-filter@fbd0ab8f3e69293af611ebaee6363fc25e6d187d # v4.0.1
        id: filter
        with:
          # All filter values use list form for consistency. `shell`
          # genuinely needs multiple paths; the others could collapse to
          # single-line strings, but mixing styles (list vs. string)
          # in the same filters block is easy to misread during review.
          filters: |
            workflow_config:
              - '.github/workflows/showcase_build.yml'
              - '.github/workflows/showcase_build_check.yml'
            shell:
              - 'showcase/shell/**'
              - 'showcase/shared/**'
              - 'showcase/scripts/**'
              - 'showcase/integrations/*/manifest.yaml'
            langgraph_python:
              - 'showcase/integrations/langgraph-python/**'
            mastra:
              - 'showcase/integrations/mastra/**'
            crewai_crews:
              - 'showcase/integrations/crewai-crews/**'
            pydantic_ai:
              - 'showcase/integrations/pydantic-ai/**'
            google_adk:
              - 'showcase/integrations/google-adk/**'
            ag2:
              - 'showcase/integrations/ag2/**'
            agno:
              - 'showcase/integrations/agno/**'
            llamaindex:
              - 'showcase/integrations/llamaindex/**'
            langgraph_fastapi:
              - 'showcase/integrations/langgraph-fastapi/**'
            langgraph_typescript:
              - 'showcase/integrations/langgraph-typescript/**'
            langroid:
              - 'showcase/integrations/langroid/**'
            spring_ai:
              - 'showcase/integrations/spring-ai/**'
            strands:
              - 'showcase/integrations/strands/**'
            ms_agent_python:
              - 'showcase/integrations/ms-agent-python/**'
            claude_sdk_typescript:
              - 'showcase/integrations/claude-sdk-typescript/**'
            ms_agent_dotnet:
              - 'showcase/integrations/ms-agent-dotnet/**'
            ms_agent_harness_dotnet:
              - 'showcase/integrations/ms-agent-harness-dotnet/**'
            claude_sdk_python:
              - 'showcase/integrations/claude-sdk-python/**'
            built_in_agent:
              - 'showcase/integrations/built-in-agent/**'
            shell_dojo:
              - 'showcase/shell-dojo/**'
              - 'showcase/shared/**'
              - 'showcase/scripts/**'
              - 'showcase/integrations/*/manifest.yaml'
            shell_dashboard:
              - 'showcase/shell-dashboard/**'
              - 'showcase/shared/**'
              - 'showcase/scripts/**'
              - 'showcase/integrations/*/manifest.yaml'
            shell_docs:
              - 'showcase/shell-docs/**'
              - 'showcase/shared/**'
              - 'showcase/scripts/**'
              - 'showcase/integrations/*/manifest.yaml'
              - 'showcase/integrations/*/docs-links.json'
              - 'showcase/integrations/*/docs/setup/**'
              - 'showcase/integrations/*/src/**'
            showcase_harness:
              - 'showcase/harness/**'
              - 'showcase/shared/**'
              - 'showcase/scripts/**'
              - 'showcase/integrations/*/manifest.yaml'
            showcase_aimock:
              - 'showcase/aimock/**'
            pocketbase:
              # PB image is self-contained: PB binary + pb_migrations +
              # pb_hooks + Dockerfile. No shared-module copy, so the slot
              # is gated purely to its own subtree — it does NOT rebuild
              # on every showcase push, only when migrations/hooks/Dockerfile
              # change.
              - 'showcase/pocketbase/**'
            webhooks:
              # Sentinel pattern that cannot match any in-tree path.
              # The webhooks GHCR image is built by the showcase-eval-webhook
              # repo's own release workflow, so we never want a push-driven
              # build run to include it. workflow_dispatch can still target
              # webhooks explicitly via the service input — that path skips
              # paths-filter entirely.
              - 'showcase/__no_match_webhooks_built_out_of_band__'

      - name: Build service matrix
        id: build-matrix
        env:
          DISPATCH_SERVICE: ${{ github.event.inputs.service }}
          GITHUB_SHA_ENV: ${{ github.sha }}
          GITHUB_REF_NAME_ENV: ${{ github.ref_name }}
          FILTER_CHANGES: ${{ steps.filter.outputs.changes }}
        run: |
          # Full service config as JSON
          # Fields: dispatch_name, filter_key, context, image, railway_id, timeout, lfs, build_args, build_args_sha, build_args_branch, dockerfile, health_path, skip_build
          # skip_build (optional, boolean): when true, the Docker build step
          # is skipped for this slot (image is built out-of-band by another
          # workflow/repo). Currently used by `webhooks` (built by the
          # showcase-eval-webhook repo's own release workflow).
          # health_path: historical field retained in the matrix for human
          # reference. The actual verify probe is driven by per-service
          # drivers in verify-deploy.ts (showcase/scripts/verify-deploy.ts),
          # NOT by this field — it is informational only at this layer.
          ALL_SERVICES='[
            {"dispatch_name":"shell","filter_key":"shell","context":".","image":"showcase-shell","railway_id":"40eea0da-6071-4ea8-bdb9-39afb19225ec","timeout":10,"lfs":true,"build_args_sha":"__GH_SHA__","build_args_branch":"__GH_REF_NAME__","dockerfile":"showcase/shell/Dockerfile","health_path":"/"},
            {"dispatch_name":"langgraph-python","filter_key":"langgraph_python","context":"showcase/integrations/langgraph-python","image":"showcase-langgraph-python","railway_id":"90d03214-4569-41b0-b4c1-6438a8a7b203","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"mastra","filter_key":"mastra","context":"showcase/integrations/mastra","image":"showcase-mastra","railway_id":"d7979eb7-2405-4aab-ad21-438f4a1b08af","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"crewai-crews","filter_key":"crewai_crews","context":"showcase/integrations/crewai-crews","image":"showcase-crewai-crews","railway_id":"0e9c284d-8d87-4fcf-9f82-6b704d7e4bd4","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"pydantic-ai","filter_key":"pydantic_ai","context":"showcase/integrations/pydantic-ai","image":"showcase-pydantic-ai","railway_id":"0a106173-2282-4887-a994-0ca276a99d69","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"google-adk","filter_key":"google_adk","context":"showcase/integrations/google-adk","image":"showcase-google-adk","railway_id":"87f60507-5a3d-4b8a-9e23-2b1de85d939c","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"ag2","filter_key":"ag2","context":"showcase/integrations/ag2","image":"showcase-ag2","railway_id":"4a37481b-f264-4eb7-a9cd-0a9ebb9ac05c","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"agno","filter_key":"agno","context":"showcase/integrations/agno","image":"showcase-agno","railway_id":"32cab80b-e329-45bd-9c73-c4e1ddc94305","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"llamaindex","filter_key":"llamaindex","context":"showcase/integrations/llamaindex","image":"showcase-llamaindex","railway_id":"285386e8-492d-4cb8-b632-0a7d4607378f","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"langgraph-fastapi","filter_key":"langgraph_fastapi","context":"showcase/integrations/langgraph-fastapi","image":"showcase-langgraph-fastapi","railway_id":"06cccb5c-59f4-46b5-8adc-7113e77011a4","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"langgraph-typescript","filter_key":"langgraph_typescript","context":"showcase/integrations/langgraph-typescript","image":"showcase-langgraph-typescript","railway_id":"66246d3b-a18e-46f0-be51-5f3ff7a36e5a","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"langroid","filter_key":"langroid","context":"showcase/integrations/langroid","image":"showcase-langroid","railway_id":"6dd9cb0a-66cc-46f1-972e-7cd74756157d","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"spring-ai","filter_key":"spring_ai","context":"showcase/integrations/spring-ai","image":"showcase-spring-ai","railway_id":"eed5d041-91be-4282-b414-beea00843401","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"strands","filter_key":"strands","context":"showcase/integrations/strands","image":"showcase-strands","railway_id":"92e1cfad-ad53-403f-ab2b-5ab380832232","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"ms-agent-python","filter_key":"ms_agent_python","context":"showcase/integrations/ms-agent-python","image":"showcase-ms-agent-python","railway_id":"655db75a-af8d-427d-a4f9-441570ae5003","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"claude-sdk-typescript","filter_key":"claude_sdk_typescript","context":"showcase/integrations/claude-sdk-typescript","image":"showcase-claude-sdk-typescript","railway_id":"18a98727-5700-44aa-b497-b60795dbbd6a","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"ms-agent-dotnet","filter_key":"ms_agent_dotnet","context":"showcase/integrations/ms-agent-dotnet","image":"showcase-ms-agent-dotnet","railway_id":"beeb2dd6-87a4-4599-aa07-0578f7bd6519","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"ms-agent-harness-dotnet","filter_key":"ms_agent_harness_dotnet","context":"showcase/integrations/ms-agent-harness-dotnet","image":"showcase-ms-agent-harness-dotnet","railway_id":"6343d7f9-6c3f-4c8d-9a6e-79f03d2f1e37","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"claude-sdk-python","filter_key":"claude_sdk_python","context":"showcase/integrations/claude-sdk-python","image":"showcase-claude-sdk-python","railway_id":"b122ab65-9854-4cb2-a68e-b50ff13f7481","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"built-in-agent","filter_key":"built_in_agent","context":"showcase/integrations/built-in-agent","image":"showcase-built-in-agent","railway_id":"f4f8371a-bc46-45b2-b6d4-9c9af608bdbf","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
            {"dispatch_name":"shell-dojo","filter_key":"shell_dojo","context":".","image":"showcase-shell-dojo","railway_id":"7ad1ece7-2228-49cd-8a78-bddf30322907","timeout":10,"lfs":false,"build_args":"","dockerfile":"showcase/shell-dojo/Dockerfile","health_path":"/"},
            {"dispatch_name":"shell-dashboard","filter_key":"shell_dashboard","context":".","image":"showcase-shell-dashboard","railway_id":"4d5dfd74-be61-40b2-8564-b53b7dd4c15b","timeout":10,"lfs":true,"build_args_sha":"__GH_SHA__","build_args_branch":"__GH_REF_NAME__","dockerfile":"showcase/shell-dashboard/Dockerfile","health_path":"/"},
            {"dispatch_name":"shell-docs","filter_key":"shell_docs","context":".","image":"showcase-shell-docs","railway_id":"7badfb8d-4228-414c-9145-b4026803714f","timeout":10,"lfs":true,"build_args_sha":"__GH_SHA__","build_args_branch":"__GH_REF_NAME__","dockerfile":"showcase/shell-docs/Dockerfile","health_path":"/"},
            {"dispatch_name":"showcase-harness","filter_key":"showcase_harness","context":".","image":"showcase-harness","railway_id":"3a14bfed-0537-4d71-897b-7c593dca161d","timeout":20,"lfs":false,"build_args":"","dockerfile":"showcase/harness/Dockerfile","health_path":"/health"},
            {"dispatch_name":"showcase-aimock","filter_key":"showcase_aimock","context":"showcase/aimock","image":"showcase-aimock","railway_id":"0fa0435d-8a66-46f0-84fd-e4250b580013","timeout":5,"lfs":false,"build_args":"","dockerfile":"showcase/aimock/Dockerfile","health_path":"/health"},
            {"dispatch_name":"showcase-pocketbase","filter_key":"pocketbase","context":"showcase/pocketbase","image":"showcase-pocketbase","railway_id":"ba11e854-d695-4738-9a45-2b0776788824","timeout":10,"lfs":false,"build_args":"","dockerfile":"showcase/pocketbase/Dockerfile","health_path":"/api/health"},
            {"dispatch_name":"webhooks","filter_key":"webhooks","context":".","image":"showcase-eval-webhook","railway_id":"ba6acc13-7585-41fe-a5ee-585b34a58fcd","timeout":5,"lfs":false,"build_args":"","dockerfile":"","health_path":"/health","skip_build":true}
          ]'

          DISPATCH="$DISPATCH_SERVICE"
          CHANGES="${FILTER_CHANGES:-[]}"

          # Filter services based on three dispatch modes:
          #   dispatch == "all": manual "deploy all" — include every service unconditionally.
          #     This re-pulls :latest for every matrix slot (~38 services); intentional for
          #     drift-rebuild runs and full-fleet restarts. Do NOT try to short-circuit
          #     unchanged services here — operators invoke "all" precisely when they want
          #     the fleet re-deployed regardless of git state (cache poisoning, base-image CVE).
          #     (paths-filter is unreliable on workflow_dispatch because there is no 'before' SHA,
          #      so we must NOT consult $changes here — doing so silently produces an empty matrix).
          #   dispatch == <specific service>: narrow to that service only (skips paths-filter so
          #     drift-rebuild and manual single-service dispatches work regardless of $changes).
          #   dispatch == "": push event — include services whose filter_key appears in paths-filter CHANGES.
          MATRIX=$(echo "$ALL_SERVICES" | jq -c --arg dispatch "$DISPATCH" --argjson changes "$CHANGES" --arg sha "$GITHUB_SHA_ENV" --arg ref "$GITHUB_REF_NAME_ENV" '
            [.[] |
              if .build_args_sha == "__GH_SHA__" then .build_args_sha = $sha else . end |
              if .build_args_branch == "__GH_REF_NAME__" then .build_args_branch = $ref else . end |
              (.filter_key as $fk | select(
              $dispatch == "all" or
              ($dispatch != "" and $dispatch != "all" and $dispatch == .dispatch_name) or
              ($dispatch == "" and (($changes | index("workflow_config") != null) or ($changes | index($fk) != null)))
            ))]
          ')

          # Fail loudly on typo'd workflow_dispatch inputs. If a user types a
          # service name that doesn't exist in ALL_SERVICES, the jq filter
          # silently produces [] and the run shows green with zero work
          # done — a common "did my dispatch deploy?" footgun. The `all` and
          # empty (push-event) modes legitimately produce [] when there are
          # no changes and must still succeed.
          #
          # The `starter-*` namespace is OWNED by the detect-starter-changes
          # job (which scopes its OWN fail-loud to `starter-*`). A
          # `service=starter-<slug>` dispatch legitimately yields [] here
          # (no showcase service is named `starter-*`), so it must SKIP — an
          # empty showcase matrix, NOT a fail-loud exit 1. Mirrors how the
          # starter job scopes its fail-loud to the `starter-*` namespace.
          case "$DISPATCH" in
            starter-*) ;; # starter namespace → empty showcase matrix + skip
            "" | "all") ;; # push / full-fleet → [] is legitimate
            *)
              if [ "$MATRIX" = "[]" ]; then
                echo "::error::workflow_dispatch service='$DISPATCH' did not match any entry in ALL_SERVICES — check the dispatch_name spelling"
                exit 1
              fi
              ;;
          esac

          echo "matrix=$MATRIX" >> $GITHUB_OUTPUT
          if [ "$MATRIX" = "[]" ]; then
            echo "has_changes=false" >> $GITHUB_OUTPUT
          else
            echo "has_changes=true" >> $GITHUB_OUTPUT
          fi

  check-lockfile:
    runs-on: ubuntu-latest
    timeout-minutes: 5
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          persist-credentials: false
      # Omit `version:` so pnpm/action-setup inherits from the repo's
      # `packageManager` field in package.json (enforced via corepack).
      # Earlier revisions hard-pinned `version: 10.13.1` which silently
      # drifted from package.json whenever the repo bumped pnpm —
      # resulting in lockfile-vs-engine mismatches that only surfaced on
      # the slow `--frozen-lockfile` path.
      - uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6.0.8
      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
        with:
          node-version: 22.x
      - run: pnpm install --frozen-lockfile --ignore-scripts

  verify-image-refs:
    needs: [detect-changes]
    if: needs.detect-changes.outputs.has_changes == 'true'
    runs-on: ubuntu-latest
    timeout-minutes: 3
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          persist-credentials: false
      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
        with:
          node-version: 22.x
      - name: Verify Railway image refs
        env:
          RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}
        run: npx tsx showcase/scripts/verify-railway-image-refs.ts

  build:
    needs: [detect-changes, check-lockfile, verify-image-refs]
    if: needs.detect-changes.outputs.has_changes == 'true'
    runs-on: depot-ubuntu-24.04-4
    timeout-minutes: ${{ fromJSON(matrix.service.timeout) }}
    permissions:
      id-token: write
      contents: read
      packages: write
    strategy:
      fail-fast: false
      matrix:
        service: ${{ fromJSON(needs.detect-changes.outputs.matrix) }}

    steps:
      - name: Checkout
        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          lfs: ${{ matrix.service.lfs }}
          persist-credentials: false

      - name: Setup Depot
        uses: depot/setup-action@15c09a5f77a0840ad4bce955686522a257853461 # v1

      - name: Login to GHCR
        uses: docker/login-action@650006c6eb7dba73a995cc03b0b2d7f5ca915bee # v4.2.0
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Prepare build args
        id: build-args
        env:
          BUILD_ARGS_SHA: ${{ matrix.service.build_args_sha }}
          BUILD_ARGS_BRANCH: ${{ matrix.service.build_args_branch }}
        run: |
          # set -euo pipefail: without `-e`, a transient `$GITHUB_OUTPUT`
          # write failure (disk pressure, ENOSPC) could silently produce
          # empty build-args and we'd ship an image without COMMIT_SHA /
          # BRANCH baked in — invisible drift between build label and
          # what's actually running.
          set -euo pipefail
          ARGS=""
          if [ -n "$BUILD_ARGS_SHA" ]; then
            ARGS="COMMIT_SHA=${BUILD_ARGS_SHA}"
            ARGS="${ARGS}"$'\n'"BRANCH=${BUILD_ARGS_BRANCH}"
          fi
          # Use delimiter to safely pass multiline value
          echo "args<<BUILDARGS_EOF" >> $GITHUB_OUTPUT
          echo "$ARGS" >> $GITHUB_OUTPUT
          echo "BUILDARGS_EOF" >> $GITHUB_OUTPUT

      - name: Copy shared modules into build context
        run: |
          set -euo pipefail
          CONTEXT="${{ matrix.service.context }}"
          # Idempotent copy: if a stale `shared_python`/`shared_typescript`
          # already exists (previous failed run on the same runner, or a
          # checkout artifact), remove it first. `cp -r src dst` into an
          # existing directory nests source-inside-destination, which
          # would silently produce a broken build context.
          if [ -d "showcase/shared/python" ] && [ -d "$CONTEXT" ]; then
            rm -rf "$CONTEXT/shared_python"
            cp -r showcase/shared/python "$CONTEXT/shared_python"
          fi
          if [ -d "showcase/shared/typescript/tools" ] && [ -d "$CONTEXT" ]; then
            rm -rf "$CONTEXT/shared_typescript"
            mkdir -p "$CONTEXT/shared_typescript"
            cp -r showcase/shared/typescript/tools "$CONTEXT/shared_typescript/tools"
          fi

          # Dereference tools/ and shared-tools/ symlinks for Docker
          # context. Integration directories use symlinks pointing to
          # ../../shared/python/tools etc. Docker cannot follow symlinks
          # outside the build context, so we replace each symlink with a
          # real copy of its target.
          for link_name in tools shared-tools; do
            link_path="$CONTEXT/$link_name"
            if [ -L "$link_path" ]; then
              target="$(readlink -f "$link_path")"
              if [ -d "$target" ]; then
                rm "$link_path"
                cp -r "$target" "$link_path"
              fi
            fi
          done

      - name: Build and push
        if: ${{ matrix.service.skip_build != true }}
        uses: depot/build-push-action@98e78adca7817480b8185f474a400b451d74e287 # v1.18.0
        with:
          project: m2kw2wmmcp
          context: ${{ matrix.service.context }}
          file: ${{ matrix.service.dockerfile != '' && matrix.service.dockerfile || format('{0}/Dockerfile', matrix.service.context) }}
          # Pin amd64: Railway and GHCR serve x86 hosts. An arm64-only
          # image crashes on pull with "does not have a linux/amd64
          # variant available".
          platforms: linux/amd64
          push: true
          tags: |
            ghcr.io/copilotkit/${{ matrix.service.image }}:latest
            ghcr.io/copilotkit/${{ matrix.service.image }}:${{ github.sha }}
          build-args: ${{ steps.build-args.outputs.args }}

      - name: Write per-slot build result
        if: always()
        env:
          SERVICE: ${{ matrix.service.dispatch_name }}
          BUILD_STATUS: ${{ job.status }}
        run: |
          # job.status is one of: success, failure, cancelled. Normalize
          # cancelled→skipped to match the BuildOutcome contract in
          # showcase/scripts/lib/build-outputs.ts. We deliberately do NOT
          # write to $GITHUB_OUTPUT — matrix-slot outputs are not
          # aggregable across slots in GitHub Actions, so we publish the
          # per-slot result as an artifact instead. The downstream
          # aggregator job downloads every `build-result-*` artifact.
          case "$BUILD_STATUS" in
            success) STATUS=success ;;
            failure) STATUS=failure ;;
            *)       STATUS=skipped ;;
          esac
          mkdir -p "$RUNNER_TEMP/build-result"
          printf '{"service":"%s","status":"%s"}\n' "$SERVICE" "$STATUS" \
            > "$RUNNER_TEMP/build-result/result.json"

      - name: Upload per-slot build-result artifact
        if: always()
        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
        with:
          # Canonical per-slot name (see buildResultArtifactName in
          # showcase/scripts/lib/build-outputs.ts). The aggregator
          # downloads every artifact matching `build-result-*`.
          name: build-result-${{ matrix.service.dispatch_name }}
          path: ${{ runner.temp }}/build-result/result.json
          if-no-files-found: error
          retention-days: 7

  # ────────────────────────────────────────────────────────────────────
  # Per-starter image publish (model B, §b stage 1 / Phase 1).
  #
  # Fully decoupled from the showcase `build`→`aggregate`→`redeploy` chain
  # above: starters are self-contained npm projects (no monorepo-source
  # build, no shared-module copy) and build from their own root Dockerfile
  # at examples/integrations/<slug>/Dockerfile (the single-image deployable:
  # Next.js frontend + agent, EXPOSE 3000, CMD entrypoint.sh — distinct from
  # the docker/Dockerfile.app + docker/Dockerfile.agent split stack used by
  # docker-compose.test.yml). Published to ghcr.io/copilotkit/starter-<slug>
  # (the `starter-` prefix is disjoint from `showcase-*`; S2's harness
  # discovery filters on namePrefix "starter-"). Railway deploy is the
  # gated S5 — NOT done here.
  #
  # The 12 starter slugs are the matrix source of truth (the smoke matrix in
  # test_smoke-starter.yml and STARTER_TO_COLUMN in
  # showcase/harness/src/probes/helpers/starter-mapping.ts). The dashboard
  # column remap lives in the harness (§a), so this layer uses raw starter
  # slugs.
  detect-starter-changes:
    runs-on: ubuntu-latest
    timeout-minutes: 5
    permissions:
      contents: read
    outputs:
      matrix: ${{ steps.starter-matrix.outputs.matrix }}
      has_changes: ${{ steps.starter-matrix.outputs.has_changes }}
    steps:
      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          persist-credentials: false

      - name: Detect changed starter paths
        uses: dorny/paths-filter@fbd0ab8f3e69293af611ebaee6363fc25e6d187d # v4.0.1
        id: filter
        with:
          filters: |
            workflow_config:
              - '.github/workflows/showcase_build.yml'
            langgraph_python:
              - 'examples/integrations/langgraph-python/**'
            mastra:
              - 'examples/integrations/mastra/**'
            langgraph_js:
              - 'examples/integrations/langgraph-js/**'
            crewai_crews:
              - 'examples/integrations/crewai-crews/**'
            pydantic_ai:
              - 'examples/integrations/pydantic-ai/**'
            adk:
              - 'examples/integrations/adk/**'
            agno:
              - 'examples/integrations/agno/**'
            llamaindex:
              - 'examples/integrations/llamaindex/**'
            langgraph_fastapi:
              - 'examples/integrations/langgraph-fastapi/**'
            strands_python:
              - 'examples/integrations/strands-python/**'
            ms_agent_framework_python:
              - 'examples/integrations/ms-agent-framework-python/**'
            ms_agent_framework_dotnet:
              - 'examples/integrations/ms-agent-framework-dotnet/**'

      - name: Build starter matrix
        id: starter-matrix
        env:
          DISPATCH_SERVICE: ${{ github.event.inputs.service }}
          FILTER_CHANGES: ${{ steps.filter.outputs.changes }}
        run: |
          set -euo pipefail
          # One slot per starter. `slug` is the examples/integrations/<slug>
          # directory name; `image` is the published GHCR repo (starter-<slug>);
          # `filter_key` matches the paths-filter key above.
          ALL_STARTERS='[
            {"slug":"langgraph-python","image":"starter-langgraph-python","filter_key":"langgraph_python"},
            {"slug":"mastra","image":"starter-mastra","filter_key":"mastra"},
            {"slug":"langgraph-js","image":"starter-langgraph-js","filter_key":"langgraph_js"},
            {"slug":"crewai-crews","image":"starter-crewai-crews","filter_key":"crewai_crews"},
            {"slug":"pydantic-ai","image":"starter-pydantic-ai","filter_key":"pydantic_ai"},
            {"slug":"adk","image":"starter-adk","filter_key":"adk"},
            {"slug":"agno","image":"starter-agno","filter_key":"agno"},
            {"slug":"llamaindex","image":"starter-llamaindex","filter_key":"llamaindex"},
            {"slug":"langgraph-fastapi","image":"starter-langgraph-fastapi","filter_key":"langgraph_fastapi"},
            {"slug":"strands-python","image":"starter-strands-python","filter_key":"strands_python"},
            {"slug":"ms-agent-framework-python","image":"starter-ms-agent-framework-python","filter_key":"ms_agent_framework_python"},
            {"slug":"ms-agent-framework-dotnet","image":"starter-ms-agent-framework-dotnet","filter_key":"ms_agent_framework_dotnet"}
          ]'

          # Dispatch modes (mirror the showcase detect-changes job):
          #   "all"                     → every starter (full-fleet rebuild).
          #   "starter-<slug>"          → that one starter (strip "starter-" prefix to match .image).
          #   "<showcase service slug>" → no starters (this is a showcase-only dispatch).
          #   "" (push event)           → starters whose filter_key appears in CHANGES
          #                               (or workflow_config touched → rebuild all).
          DISPATCH="${DISPATCH_SERVICE:-}"
          CHANGES="${FILTER_CHANGES:-[]}"

          # `.image` is exactly "starter-<slug>", which is also the
          # workflow_dispatch choice value, so a specific-starter dispatch
          # matches `$dispatch == .image` directly.
          MATRIX=$(echo "$ALL_STARTERS" | jq -c --arg dispatch "$DISPATCH" --argjson changes "$CHANGES" '
            [.[] |
              (.filter_key as $fk | select(
              $dispatch == "all" or
              ($dispatch != "" and $dispatch != "all" and $dispatch == .image) or
              ($dispatch == "" and (($changes | index("workflow_config") != null) or ($changes | index($fk) != null)))
            ))]
          ')

          # Fail loudly on a typo'd starter dispatch (mirrors showcase job).
          # Only applies to the starter-* dispatch namespace; a showcase
          # service slug or "all" legitimately yields [] here.
          case "$DISPATCH" in
            starter-*)
              if [ "$MATRIX" = "[]" ]; then
                echo "::error::workflow_dispatch service='$DISPATCH' did not match any starter — check the slug"
                exit 1
              fi
              ;;
          esac

          echo "matrix=$MATRIX" >> "$GITHUB_OUTPUT"
          if [ "$MATRIX" = "[]" ]; then
            echo "has_changes=false" >> "$GITHUB_OUTPUT"
          else
            echo "has_changes=true" >> "$GITHUB_OUTPUT"
          fi

  build-starters:
    needs: [detect-starter-changes]
    if: needs.detect-starter-changes.outputs.has_changes == 'true'
    runs-on: depot-ubuntu-24.04-4
    timeout-minutes: 20
    permissions:
      id-token: write
      contents: read
      packages: write
    strategy:
      fail-fast: false
      matrix:
        starter: ${{ fromJSON(needs.detect-starter-changes.outputs.matrix) }}

    steps:
      - name: Checkout
        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          persist-credentials: false

      - name: Setup Depot
        uses: depot/setup-action@15c09a5f77a0840ad4bce955686522a257853461 # v1

      - name: Login to GHCR
        uses: docker/login-action@650006c6eb7dba73a995cc03b0b2d7f5ca915bee # v4.2.0
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Build and push starter image
        uses: depot/build-push-action@98e78adca7817480b8185f474a400b451d74e287 # v1.18.0
        with:
          project: m2kw2wmmcp
          context: examples/integrations/${{ matrix.starter.slug }}
          file: examples/integrations/${{ matrix.starter.slug }}/Dockerfile
          # Pin amd64: Railway and GHCR serve x86 hosts. Depot defaults to
          # the runner's native arch, so an arm64-only image would crash on
          # pull with "does not have a linux/amd64 variant available".
          platforms: linux/amd64
          push: true
          tags: |
            ghcr.io/copilotkit/${{ matrix.starter.image }}:latest
            ghcr.io/copilotkit/${{ matrix.starter.image }}:${{ github.sha }}

  aggregate-build-results:
    name: Aggregate build results
    needs: [detect-changes, build]
    if: ${{ !cancelled() && needs.detect-changes.outputs.has_changes == 'true' }}
    runs-on: ubuntu-latest
    timeout-minutes: 3
    permissions:
      contents: read
    outputs:
      results: ${{ steps.collect.outputs.results }}
      any_success: ${{ steps.collect.outputs.any_success }}
    steps:
      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          persist-credentials: false

      - name: Setup pnpm
        uses: pnpm/action-setup@0e279bb959325dab635dd2c09392533439d90093 # v6.0.8
      - name: Setup Node
        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
        with:
          node-version: 22.x
          cache: pnpm
      - name: Install
        run: pnpm install --frozen-lockfile --ignore-scripts

      - name: Download all per-slot build-result artifacts
        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
        with:
          # `pattern` matches every per-slot artifact emitted by the
          # build matrix. `merge-multiple: false` keeps each artifact
          # in its own subdirectory so we can iterate them deterministically.
          pattern: build-result-*
          path: ${{ runner.temp }}/build-results-in
          merge-multiple: false

      - name: Collect per-service build outcomes
        id: collect
        env:
          INPUT_DIR: ${{ runner.temp }}/build-results-in
          OUTPUT_DIR: ${{ runner.temp }}/build-results-out
        run: |
          set -euo pipefail
          mkdir -p "$OUTPUT_DIR"
          # Each per-slot artifact extracts to
          #   $INPUT_DIR/build-result-<dispatch_name>/result.json
          # The aggregator script (showcase/scripts/aggregate-build-results.ts)
          # reads them, merges via the shared helper (mergeBuildResultFiles),
          # writes $OUTPUT_DIR/results.json, and appends `results` +
          # `any_success` to $GITHUB_OUTPUT. The contract (service +
          # status enum) is enforced in one place (build-outputs.ts).
          npx tsx showcase/scripts/aggregate-build-results.ts

      - name: Upload aggregated build-results artifact
        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
        with:
          name: build-results
          path: ${{ runner.temp }}/build-results-out/results.json
          if-no-files-found: error
          retention-days: 7

  redeploy-staging:
    name: Trigger Railway staging redeploy
    needs: [detect-changes, build, aggregate-build-results]
    # Run if at least one service was in the matrix AND the build job
    # was not outright cancelled or skipped AND at least one slot
    # succeeded (per aggregate-build-results.outputs.any_success). The
    # any_success guard is the explicit "do not redeploy when nothing
    # was pushed" check — without it, an all-failed build run would
    # still kick a redeploy that just re-pulls the stale :latest and
    # silently looks healthy. The skipped/cancelled checks on the build
    # job still cover the "verify-image-refs gate blocked the build job
    # entirely" path. Partial build failures (fail-fast: false) still
    # surface as needs.build.result == 'failure' with any_success ==
    # 'true', so redeploying what did get pushed is preserved.
    if: >-
      ${{ !cancelled()
          && needs.detect-changes.outputs.has_changes == 'true'
          && needs.build.result != 'skipped'
          && needs.build.result != 'cancelled'
          && needs.aggregate-build-results.outputs.any_success == 'true' }}
    runs-on: ubuntu-latest
    timeout-minutes: 5
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          persist-credentials: false
      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
        with:
          node-version: 22.x
      - name: Compute changed-service list from build matrix
        id: changed
        env:
          MATRIX_JSON: ${{ needs.detect-changes.outputs.matrix }}
          BUILD_RESULTS_JSON: ${{ needs.aggregate-build-results.outputs.results }}
        run: |
          # We feed the redeploy script with the INTERSECTION of:
          #   (a) the scheduled build matrix (detect-changes.outputs.matrix —
          #       JSON array of objects with `dispatch_name`), and
          #   (b) the SUCCESS set from the aggregator
          #       (aggregate-build-results.outputs.results — JSON array of
          #       `{service: <dispatch_name>, status: success|failure|skipped}`;
          #       the `service` field is the dispatch_name; shape defined in
          #       showcase/scripts/lib/build-outputs.ts).
          # Without this intersection a service whose Docker build FAILED
          # would still be in the redeploy CSV, Railway would re-pull its
          # stale `:latest`, and the verify workflow would report it as a
          # fresh, healthy deploy — a false green. Skipped slots are also
          # excluded (only `status == "success"` qualifies).
          set -euo pipefail
          matrix_names="$(echo "$MATRIX_JSON" | jq -r '[.[] | .dispatch_name]')"
          success_names="$(echo "$BUILD_RESULTS_JSON" | jq -r '[.[] | select(.status == "success") | .service]')"
          csv="$(jq -rn --argjson m "$matrix_names" --argjson s "$success_names" \
            '($m | map(select(. as $n | $s | index($n)))) | join(",")')"
          if [ -z "$csv" ]; then
            echo "No services in matrix ∩ success-set — skipping redeploy."
            echo "services=" >> "$GITHUB_OUTPUT"
          else
            echo "services=$csv" >> "$GITHUB_OUTPUT"
          fi
          echo "Computed services CSV (matrix ∩ build-success): $csv"
      - name: Redeploy changed services in staging
        if: steps.changed.outputs.services != ''
        env:
          RAILWAY_TOKEN: ${{ secrets.RAILWAY_TOKEN }}
          SERVICES_CSV: ${{ steps.changed.outputs.services }}
          # Bridge the per-service redeploy summary to showcase_deploy.yml's
          # `enforce-redeploy-gate` (consumed via the `redeploy-summary`
          # artifact, extracted to `.redeploy/summary.json`). redeploy-env.ts
          # writes this path atomically (.tmp → rename) but does NOT create
          # parent dirs, so the step below mkdir's `.redeploy` first.
          REDEPLOY_SUMMARY_JSON: .redeploy/summary.json
        run: |
          # Staging is non-blocking by design: the script always exits 0
          # and writes per-service failures into $GITHUB_STEP_SUMMARY. The
          # verify-deploy workflow is the real release gate.
          mkdir -p .redeploy
          npx tsx showcase/scripts/redeploy-env.ts staging --services "$SERVICES_CSV"

      - name: Upload redeploy summary
        # Upload is MANDATORY whenever a redeploy was attempted (services
        # != ''). Both failure modes red the build — no false-green path:
        #
        #   (A) HARD crash inside redeploy-env.ts BEFORE summary.json is
        #       written. redeploy-env.ts writes the summary atomically
        #       (.tmp → rename) AFTER the per-service loop completes, so
        #       a crash leaves no file. The redeploy step itself exits
        #       non-zero on that crash and fails the redeploy-staging
        #       job; this upload step is then skipped entirely by
        #       step-failure propagation. Build → red.
        #
        #   (B) redeploy step exits 0 but summary.json is absent (e.g. a
        #       logic bug skipped the write). `if-no-files-found: error`
        #       reds this step → reds the redeploy-staging job → reds the
        #       build. The deploy workflow's resolve-matrix.if
        #       (workflow_run.conclusion == 'success') then blocks the
        #       deploy run from starting at all.
        #
        # Do NOT add hashFiles() guards here: that would silently skip
        # the upload on (B), the deploy workflow would see "artifact
        # absent" via check-redeploy-summary, treat it as "nothing
        # redeployed", skip the gate, and ship a false-green.
        # The legitimate "services == '' → nothing redeployed → no upload"
        # path is preserved by the services != '' guard.
        #
        # If a future change ever switches this step to `if: always()`,
        # `if-no-files-found: error` STILL reds path (A): the redeploy
        # step's non-zero exit on a HARD crash is independent of upload
        # gating, and `if-no-files-found: error` on `always()` then trips
        # because summary.json was never written. So neither relaxation
        # alone opens a false-green window.
        #
        # However, swapping the guard to `if: always()` would ALSO red the
        # legitimate `services == ''` (nothing-to-redeploy) path — no
        # summary.json is written there either, so `if-no-files-found:
        # error` would trip on every push that didn't redeploy anything.
        # Net effect: trades the (already-closed) false-green risk for a
        # false-red on every non-buildable push. Don't do it.
        if: steps.changed.outputs.services != ''
        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
        with:
          # Artifact name MUST stay `redeploy-summary`: showcase_deploy.yml's
          # `resolve-matrix` job downloads it by this exact name and reads
          # `.redeploy/summary.json` inside.
          name: redeploy-summary
          path: .redeploy/summary.json
          if-no-files-found: error
          retention-days: 7

  notify-all-builds-failed:
    name: Notify all builds failed (staging unchanged)
    needs: [detect-changes, build, aggregate-build-results]
    # Explicit "everything failed; nothing redeployed" signal — distinct
    # from the `notify:` job below which fires on any build-job failure
    # (some slots may still have succeeded in that case). Both jobs can
    # fire; that's intentional and matches the Slack alert SOP.
    if: >-
      ${{ !cancelled()
          && needs.detect-changes.outputs.has_changes == 'true'
          && needs.build.result == 'failure'
          && needs.aggregate-build-results.outputs.any_success == 'false' }}
    # The `needs.build.result == 'failure'` clause guards against the case
    # where the build job itself was SKIPPED (e.g. verify-image-refs failed
    # upstream, so the matrix never executed). Without it, the aggregator
    # would still report `any_success=false` and we'd Slack-spam "all
    # builds failed" even though builds never ran — a misleading alert.
    runs-on: ubuntu-latest
    timeout-minutes: 3
    permissions:
      contents: read
    env:
      SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK_OSS_ALERTS }}
    steps:
      - name: Mark workflow red (no service succeeded)
        run: |
          echo "::error::All builds failed for this run; staging redeploy skipped; :latest unchanged."
          exit 1
      - name: Slack #oss-alerts
        if: always() && env.SLACK_WEBHOOK != ''
        uses: slackapi/slack-github-action@b0fa283ad8fea605de13dc3f449259339835fc52 # v2.1.0
        with:
          webhook: ${{ secrets.SLACK_WEBHOOK_OSS_ALERTS }}
          webhook-type: incoming-webhook
          # NOTE: `\n` is NOT an escape sequence in GitHub Actions expression
          # string literals — `format()` would emit the two literal characters
          # backslash+n, which `toJSON` then encodes as `\\n`, so Slack renders
          # a literal "\n". Inject real newlines via `fromJSON('"\n"')` ({4}) so
          # `toJSON` encodes them as a single `\n` that Slack honors.
          payload: |
            { "text": ${{ toJSON(format(':x: *Showcase: all builds failed*{4}staging unchanged (no redeploy){4}Commit: `{0}` by {1}{4}<https://github.com/{2}/actions/runs/{3}|View run>', github.sha, github.actor, github.repository, github.run_id, fromJSON('"\n"'))) }} }

  notify:
    name: Notify on failure
    # Cover the whole detect→build→aggregate→redeploy pipeline. `needs: [build]`
    # alone meant a failure in aggregate-build-results or redeploy-staging
    # produced ZERO Slack signal (verify just never ran). Likewise, a red
    # in detect-changes, check-lockfile, or verify-image-refs would skip
    # `build` (skipped != failure) so the original `needs: [build]` form
    # also missed those pre-build red paths. Adding the early-stage jobs
    # to `needs` extends the alert surface to the full workflow, matching
    # the workflow-level notify pattern in showcase_promote.yml.
    # `if: failure()` already skips when none of the needs failed — so
    # this still no-ops for the "no changes → build skipped" path, since
    # skipped != failure. If `notify-all-builds-failed` also fires
    # (genuine all-failed case), both alerts firing for the same event is
    # acceptable per the alert SOP.
    needs:
      [
        detect-changes,
        check-lockfile,
        verify-image-refs,
        build,
        aggregate-build-results,
        redeploy-staging,
      ]
    if: failure()
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
      issues: write
    timeout-minutes: 5
    env:
      SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK_OSS_ALERTS }}
    steps:
      - name: Slack alert
        if: env.SLACK_WEBHOOK != ''
        uses: slackapi/slack-github-action@b0fa283ad8fea605de13dc3f449259339835fc52 # v2.1.0
        with:
          webhook: ${{ secrets.SLACK_WEBHOOK_OSS_ALERTS }}
          webhook-type: incoming-webhook
          # NOTE: `\n` is NOT an escape sequence in GitHub Actions expression
          # string literals — `format()` would emit the two literal characters
          # backslash+n, which `toJSON` then encodes as `\\n`, so Slack renders
          # a literal "\n". Inject real newlines via `fromJSON('"\n"')` ({4}) so
          # `toJSON` encodes them as a single `\n` that Slack honors.
          payload: |
            { "text": ${{ toJSON(format(':x: *Showcase Build Failed*{4}Commit: `{0}` by {1}{4}<https://github.com/{2}/actions/runs/{3}|View run>', github.sha, github.actor, github.repository, github.run_id, fromJSON('"\n"'))) }} }

      - name: Comment on PR
        uses: actions/github-script@f28e40c7f34bde8b3046d885e986cb6290c5673b # v7
        with:
          script: |
            const { data: prs } = await github.rest.repos.listPullRequestsAssociatedWithCommit({
              owner: context.repo.owner,
              repo: context.repo.repo,
              commit_sha: context.sha,
            });
            const merged = prs.find(pr => pr.merged_at);
            if (!merged) {
              console.log('No merged PR found for this commit — skipping comment');
              return;
            }
            const marker = '<!-- showcase-build-failure -->';
            const body = [
              marker,
              `### :x: Showcase Build Failed`,
              ``,
              `The Docker build triggered by this PR's merge failed.`,
              ``,
              `**Run:** ${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}`,
              `**Commit:** \`${context.sha.slice(0, 8)}\``,
              ``,
              `@${merged.user?.login ?? 'unknown'} — please check the build logs and fix the issue.`,
            ].join('\n');

            const { data: comments } = await github.rest.issues.listComments({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: merged.number,
            });
            const existing = comments.find(c => c.body?.includes(marker));
            if (existing) {
              await github.rest.issues.updateComment({
                owner: context.repo.owner,
                repo: context.repo.repo,
                comment_id: existing.id,
                body,
              });
            } else {
              await github.rest.issues.createComment({
                owner: context.repo.owner,
                repo: context.repo.repo,
                issue_number: merged.number,
                body,
              });
            }